Disconnect-ExchangeOnline
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
DefaultParameterSet (Standardwert)
Disconnect-ExchangeOnline
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ConnectionId
Disconnect-ExchangeOnline
-ConnectionId <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ModulePrefix
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 Security & Compliance PowerShell trennen.
Beispiel 2
Disconnect-ExchangeOnline -Confirm:$false
In diesem Beispiel wird die Verbindung von Exchange Online PowerShell oder Security & Compliance PowerShell 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 PowerShell-Remoteverbindungen mit Exchange Online PowerShell oder Security & Compliance PowerShell im selben 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 PowerShell-Remoteverbindungen mit Exchange Online PowerShell oder Security & Compliance PowerShell im selben Windows PowerShell Fenster werden ebenfalls getrennt.
Parameter
-Confirm
Anwendbar: Exchange Online
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 (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (beispielsweise 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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ConnectionId
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.2.0-Preview2 oder höher 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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ConnectionId
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ModulePrefix
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.2.0-Preview2 oder höher 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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ModulePrefix
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: Exchange Online
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.