Disconnect-ExchangeOnline

此 cmdlet 仅在 Exchange Online PowerShell 模块中可用。 有关详细信息,请参阅关于 Exchange Online PowerShell 模块

使用 Exchange Online PowerShell 模块中的 Disconnect-ExchangeOnline cmdlet 断开使用 Connect-ExchangeOnline 或 Connect-IPPSSession cmdlet 创建的连接。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

DefaultParameterSet (默认值)

Disconnect-ExchangeOnline

    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

ConnectionId

Disconnect-ExchangeOnline
    -ConnectionId <String[]>
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

ModulePrefix

Disconnect-ExchangeOnline
    -ModulePrefix <String[]>
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

说明

此 cmdlet 是 Connect-ExchangeOnline 和 Connect-IPPSSession cmdlet 的对应项。

此 cmdlet 断开所有连接并清除缓存。 成功断开连接后,无法为组织成功运行任何 cmdlet。

如果用于连接的帐户的配置文件路径包含特殊 PowerShell 字符, (例如) , $ 则断开连接命令可能会失败。 解决方法是使用配置文件路径中没有特殊字符的其他帐户进行连接。

示例

示例 1

Disconnect-ExchangeOnline

本示例在断开与 PowerShell 或安全性 Exchange Online & 符合性 PowerShell 的连接之前要求确认。

示例 2

Disconnect-ExchangeOnline -Confirm:$false

此示例在没有确认提示或任何通知文本的情况下,以静默方式断开与 Exchange Online PowerShell 或安全性 & 符合性 PowerShell 的连接。

示例 3

Disconnect-ExchangeOnline -ConnectionId 1a9e45e8-e7ec-498f-9ac3-0504e987fa85

此示例使用指定的 ConnectionId 值断开基于 REST Exchange Online PowerShell 连接。 在同一Windows PowerShell窗口中Exchange Online PowerShell 或安全性 & 符合性 PowerShell 的任何其他远程 PowerShell 连接也会断开连接。

示例 4

Disconnect-ExchangeOnline -ModulePrefix Contoso,Fabrikam

此示例断开使用指定前缀值的基于 REST Exchange Online PowerShell 连接。 在同一Windows PowerShell窗口中Exchange Online PowerShell 或安全性 & 符合性 PowerShell 的任何其他远程 PowerShell 连接也会断开连接。

参数

-Confirm

适用:Exchange Online

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ConnectionId

适用:Exchange Online

注意:此参数在模块的 3.2.0 或更高版本中可用。

ConnectionId 参数通过 ConnectionId 指定要断开连接的 REST API 连接。 ConnectionId 是 Get-ConnectionInformation cmdlet 输出中的 GUID 值,用于唯一标识连接,即使打开了多个连接也是如此。 可以指定以逗号分隔的多个 ConnectionId 值。

不要将此参数与 ModulePrefix 参数一起使用。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

ConnectionId
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ModulePrefix

适用:Exchange Online

注意:此参数在模块的 3.2.0 或更高版本中可用。

ModulePrefix 参数指定要通过 ModulePrefix 断开连接的 REST API 连接。 将 Prefix 参数与 Connect-ExchangeOnline cmdlet 一起使用时,指定的文本将添加到所有Exchange Online cmdlet 的名称 (例如,Get-InboundConnector 变为 Get-ContosoInboundConnector) 。 ModulePrefix 值在 Get-ConnectionInformation cmdlet 的输出中可见。 可以指定多个用逗号分隔的 ModulePrefix 值。

不要将此参数与 ConnectionId 参数一起使用。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

ModulePrefix
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

适用:Exchange Online

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters