Disconnect-ExchangeOnline
Dieses Cmdlet ist nur im PowerShell-Modul Exchange Online verfügbar. Weitere Informationen finden Sie unter Informationen zum PowerShell-Modul von Exchange Online.
Verwenden Sie das Disconnect-ExchangeOnline Cmdlet im Exchange Online PowerShell-Modul, um die Verbindungen zu trennen, die Sie mit den Connect-ExchangeOnline- oder Connect-IPPSSession-Cmdlets erstellt haben.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
DefaultParameterSet (Standard)
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 Gegenstück 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 erfolgreich ausführen.
Trennungsbefehle werden wahrscheinlich fehlschlagen, wenn der Profilpfad des Kontos, das Sie zum Herstellen der Verbindung verwendet haben, $PowerShell-Sonderzeichen enthält (z. B. ). Die Problemumgehung besteht darin, eine Verbindung mithilfe eines anderen Kontos herzustellen, das keine Sonderzeichen im Profilpfad enthält.
Beispiele
Beispiel 1
Disconnect-ExchangeOnline
In diesem Beispiel werden Sie zur Bestätigung aufgefordert, bevor die Verbindung zu Exchange Online PowerShell oder Security & Compliance PowerShell getrennt wird.
Beispiel 2
Disconnect-ExchangeOnline -Confirm:$false
Dieses Beispiel trennt automatisch die Verbindung zu Exchange Online PowerShell oder Security & Compliance PowerShell, ohne dass eine Bestätigungsaufforderung oder ein Benachrichtigungstext angezeigt wird.
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 zu 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 Remote-PowerShell-Verbindungen zu 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 sich diese Option auf das Cmdlet auswirkt, hängt davon ab, ob für das Cmdlet eine Bestätigung erforderlich ist, bevor Sie fortfahren.
- 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 die Angabe des Bestätigungsschalters ohne Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.
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 anhand von ConnectionId getrennt werden sollen. ConnectionId ist ein GUID-Wert in der Ausgabe des Get-ConnectionInformation-Cmdlets, 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: | True |
| 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 Prefix-Parameter mit dem Connect-ExchangeOnline Cmdlet verwenden, wird der angegebene Text zu den Namen aller Exchange Online Cmdlets hinzugefügt (beispielsweise wird Get-InboundConnector zu Get-ContosoInboundConnector). Der ModulePrefix-Wert ist in der Ausgabe des Get-ConnectionInformation Cmdlets sichtbar. Sie können mehrere ModulePrefix-Werte angeben, die durch Kommas getrennt sind.
Verwenden Sie diesen Parameter nicht mit dem Parameter ConnectionId.
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
Der Schalter "WhatIf" zeigt die Funktion des Befehls an, ohne Änderungen vorzunehmen. 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.