Disconnect-ExchangeOnline

Modul:

ExchangePowerShell

Gilt für::

Exchange Online

Dieses Cmdlet ist nur im Exchange Online PowerShell-Modul verfügbar. Weitere Informationen finden Sie unter Informationen zum Exchange Online PowerShell-Moduls.

Verwenden Sie das Cmdlet Disconnect-ExchangeOnline im Exchange Online PowerShell-Modul, um die Verbindungen zu trennen, die Sie mit den Cmdlets Connect-ExchangeOnline oder Connect-IPPSSession erstellt haben.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

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

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

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

Beschreibung

Dieses Cmdlet ist das Pendant zu den Cmdlets Connect-ExchangeOnline und Connect-IPPSSession.

Dieses Cmdlet trennt alle Verbindungen und löscht den Cache. Nach einer erfolgreichen Trennung können Sie keine Cmdlets für Ihre organization ausführen.

Die Trennungsbefehle schlagen wahrscheinlich fehl, wenn der Profilpfad des Kontos, das Sie für die Verbindung verwendet haben, $spezielle PowerShell-Zeichen enthält (z. B. ). Die Problemumgehung besteht darin, eine Verbindung mit einem anderen Konto herzustellen, das keine Sonderzeichen im Profilpfad enthält.

Beispiele

Beispiel 1

Disconnect-ExchangeOnline

In diesem Beispiel wird zur Bestätigung aufgefordert, bevor Sie die Verbindung mit Exchange Online PowerShell oder PowerShell zur Sicherheitskonformität & trennen.

Beispiel 2

Disconnect-ExchangeOnline -Confirm:$false

In diesem Beispiel wird die Verbindung mit Exchange Online PowerShell oder PowerShell zur Sicherheitskonformität & ohne Bestätigungsaufforderung oder Benachrichtigungstext automatisch getrennt.

Beispiel 3

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

In diesem Beispiel wird die REST-basierte Exchange Online PowerShell-Verbindung mit dem angegebenen ConnectionId-Wert getrennt. Alle anderen Remote-PowerShell-Verbindungen mit Exchange Online PowerShell oder PowerShell zur Sicherheitskonformität & in demselben Windows PowerShell Fenster werden ebenfalls getrennt.

Beispiel 4

Disconnect-ExchangeOnline -ModulePrefix Contoso,Fabrikam

In diesem Beispiel werden die REST-basierten Exchange Online PowerShell-Verbindungen getrennt, die die angegebenen Präfixwerte verwenden. Alle anderen Remote-PowerShell-Verbindungen mit Exchange Online PowerShell oder PowerShell zur Sicherheitskonformität & in demselben Windows PowerShell Fenster werden ebenfalls getrennt.

Parameter

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

• Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
• Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ConnectionId

Hinweis: Dieser Parameter ist in Version 3.2.0 oder höher des Moduls verfügbar.

Der Parameter ConnectionId gibt die REST-API-Verbindungen an, die durch ConnectionId getrennt werden sollen. ConnectionId ist ein GUID-Wert in der Ausgabe des cmdlets Get-ConnectionInformation, der eine Verbindung eindeutig identifiziert, auch wenn mehrere Verbindungen geöffnet sind. Sie können mehrere ConnectionId-Werte angeben, die durch Kommas getrennt sind.

Verwenden Sie diesen Parameter nicht mit dem Parameter ModulePrefix.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ModulePrefix

Hinweis: Dieser Parameter ist in Version 3.2.0 oder höher des Moduls verfügbar.

Der Parameter ModulePrefix gibt die REST-API-Verbindungen an, die durch ModulePrefix getrennt werden sollen. Wenn Sie den Parameter Prefix mit dem Cmdlet Connect-ExchangeOnline verwenden, wird der angegebene Text den Namen aller Exchange Online Cmdlets hinzugefügt (z. B. wird Get-InboundConnector zu Get-ContosoInboundConnector). Der Wert ModulePrefix wird in der Ausgabe des Cmdlets Get-ConnectionInformation angezeigt. Sie können mehrere ModulePrefix-Werte durch Kommas getrennt angeben.

Verwenden Sie diesen Parameter nicht mit dem ConnectionId-Parameter.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online