Disconnect-ExchangeOnline

參考

模組:: ExchangePowerShell

適用於:: Exchange Online

此 Cmdlet 僅適用于 Exchange Online PowerShell 模組。如需詳細資訊，請參閱關於 Exchange Online PowerShell 模組。

使用 Exchange Online PowerShell 模組中的 Disconnect-ExchangeOnline Cmdlet，中斷您使用 Connect-ExchangeOnline 或 Connect-IPPSSession Cmdlet 建立的連線。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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

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

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

Description

此 Cmdlet 是與 Connect-ExchangeOnline 和 Connect-IPPSSession Cmdlet 的對應專案。

此 Cmdlet 會中斷任何連線並清除快取。成功中斷連線之後，您就無法成功為組織執行任何 Cmdlet。

如果您用來連線之帳戶的設定檔路徑包含特殊 PowerShell 字元 (例如，) ， $ 中斷連線命令可能會失敗。因應措施是使用設定檔路徑中沒有特殊字元的不同帳戶進行連線。

範例

範例 1

Disconnect-ExchangeOnline

此範例會先要求確認，再中斷與 Exchange Online PowerShell 或安全 & 性合規性 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

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