Disconnect-ExchangeOnline
此 cmdlet 仅在 Exchange Online PowerShell 模块中可用。 有关详细信息,请参阅关于 Exchange Online PowerShell 模块。
使用 Exchange Online PowerShell 模块中的 Disconnect-ExchangeOnline cmdlet 断开使用 Connect-ExchangeOnline 或 Connect-IPPSSession cmdlet 创建的连接。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Disconnect-ExchangeOnline
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Disconnect-ExchangeOnline
-ConnectionId <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Disconnect-ExchangeOnline
-ModulePrefix <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
说明
此 cmdlet 是 Connect-ExchangeOnline 和 Connect-IPPSSession cmdlet 的对应项。
此 cmdlet 断开所有连接并清除缓存。 成功断开连接后,无法为组织成功运行任何 cmdlet。
如果用于连接的帐户的配置文件路径包含特殊 PowerShell 字符, (例如) , $
则断开连接命令可能会失败。 解决方法是使用配置文件路径中没有特殊字符的其他帐户进行连接。
示例
示例 1
Disconnect-ExchangeOnline
本示例在与 PowerShell 或安全&合规性 PowerShell 断开连接之前要求确认Exchange Online。
示例 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
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet (例如,Remove-* cmdlet) 具有内置的暂停,该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false
。 - 大多数其他 cmdlet (例如,New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ConnectionId
注意:此参数在模块的 3.2.0 或更高版本中可用。
ConnectionId 参数通过 ConnectionId 指定要断开连接的 REST API 连接。 ConnectionId 是 Get-ConnectionInformation cmdlet 输出中的 GUID 值,用于唯一标识连接,即使打开了多个连接也是如此。 可以指定以逗号分隔的多个 ConnectionId 值。
不要将此参数与 ModulePrefix 参数一起使用。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModulePrefix
注意:此参数在模块的 3.2.0 或更高版本中可用。
ModulePrefix 参数指定要通过 ModulePrefix 断开连接的 REST API 连接。 将 Prefix 参数与 Connect-ExchangeOnline cmdlet 一起使用时,指定的文本将添加到所有Exchange Online cmdlet 的名称 (例如,Get-InboundConnector变为 Get-ContosoInboundConnector) 。 ModulePrefix 值在 Get-ConnectionInformation cmdlet 的输出中可见。 可以指定多个用逗号分隔的 ModulePrefix 值。
不要将此参数与 ConnectionId 参数一起使用。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |