Disconnect-ExchangeOnline
Cette applet de commande est disponible uniquement dans le module PowerShell d’Exchange Online. Pour plus d’informations, consultez À propos du module Exchange Online PowerShell.
Utilisez l’applet de commande Disconnect-ExchangeOnline du module PowerShell Exchange Online pour déconnecter les connexions créées à l’aide des applets de commande Connect-ExchangeOnline ou Connect-IPPSSession.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
DefaultParameterSet (Par défaut)
Disconnect-ExchangeOnline
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ConnectionId
Disconnect-ExchangeOnline
-ConnectionId <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ModulePrefix
Disconnect-ExchangeOnline
-ModulePrefix <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Cette applet de commande est la contrepartie des applets de commande Connect-ExchangeOnline et Connect-IPPSSession.
Cette applet de commande déconnecte toutes les connexions et efface le cache. Après une déconnexion réussie, vous ne pouvez pas exécuter d’applets de commande pour votre organisation.
Les commandes de déconnexion échoueront probablement si le chemin d’accès du profil du compte que vous avez utilisé pour vous connecter contient des caractères PowerShell spéciaux (par exemple, $). La solution consiste à se connecter à l’aide d’un autre compte qui ne comporte pas de caractères spéciaux dans le chemin d’accès du profil.
Exemples
Exemple 1
Disconnect-ExchangeOnline
Cet exemple demande une confirmation avant de se déconnecter de Exchange Online PowerShell ou de Security & Compliance PowerShell.
Exemple 2
Disconnect-ExchangeOnline -Confirm:$false
Cet exemple se déconnecte silencieusement de Exchange Online PowerShell ou de & de conformité de sécurité sans invite de confirmation ni texte de notification.
Exemple 3
Disconnect-ExchangeOnline -ConnectionId 1a9e45e8-e7ec-498f-9ac3-0504e987fa85
Cet exemple déconnecte la connexion PowerShell REST basée sur Exchange Online avec la valeur ConnectionId spécifiée. Toutes les autres connexions PowerShell distantes à Exchange Online PowerShell ou à & de sécurité PowerShell de conformité dans la même fenêtre Windows PowerShell sont également déconnectées.
Exemple 4
Disconnect-ExchangeOnline -ModulePrefix Contoso,Fabrikam
Cet exemple déconnecte les connexions PowerShell REST basées sur Exchange Online qui utilisent les valeurs de préfixe spécifiées. Toutes les autres connexions PowerShell distantes à Exchange Online PowerShell ou à & de sécurité PowerShell de conformité dans la même fenêtre Windows PowerShell sont également déconnectées.
Paramètres
-Confirm
Applicable : Exchange Online
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false. - La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ConnectionId
Applicable : Exchange Online
Remarque : ce paramètre est disponible dans la version de module 3.2.0-Preview2 ou ultérieure.
Le paramètre ConnectionId spécifie les connexions d’API REST à déconnecter en fonction de ConnectionId. ConnectionId est une valeur GUID dans la sortie de l’applet de commande Get-ConnectionInformation qui identifie de manière unique une connexion, même si vous avez plusieurs connexions ouvertes. Vous pouvez spécifier plusieurs valeurs ConnectionId séparées par des virgules.
N’utilisez pas ce paramètre avec le paramètre ModulePrefix.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ConnectionId
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ModulePrefix
Applicable : Exchange Online
Remarque : ce paramètre est disponible dans la version de module 3.2.0-Preview2 ou ultérieure.
Le paramètre ModulePrefix spécifie les connexions d’API REST à déconnecter par ModulePrefix. Lorsque vous utilisez le paramètre Prefix avec la cmdlet Connect-ExchangeOnline, le texte spécifié est ajouté aux noms de toutes les Exchange Online cmdlets (par exemple, Get-InboundConnector devient Get-ContosoInboundConnector). La valeur ModulePrefix est visible dans la sortie de l’applet de commande Get-ConnectionInformation. Vous pouvez spécifier plusieurs valeurs ModulePrefix séparées par des virgules.
N’utilisez pas ce paramètre avec le paramètre ConnectionId.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ModulePrefix
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Online
Le commutateur WhatIf affiche ce que la commande fait sans apporter de modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.