Disconnect-ExchangeOnline

Cette applet de commande est disponible uniquement dans le module PowerShell Exchange Online. Pour plus d’informations, consultez À propos du module PowerShell Exchange Online.

Utilisez l’applet de commande Disconnect-ExchangeOnline dans le module PowerShell Exchange Online pour déconnecter les connexions que vous avez 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.

Syntax

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

Description

Cette applet de commande est l’équivalent 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 organization.

Les commandes de déconnexion échouent probablement si le chemin du profil du compte que vous avez utilisé pour vous connecter contient des caractères PowerShell spéciaux (par exemple, $). La solution de contournement consiste à se connecter à l’aide d’un autre compte qui n’a 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 vous déconnecter de Exchange Online PowerShell ou de PowerShell de conformité de la sécurité&.

Exemple 2

Disconnect-ExchangeOnline -Confirm:$false

Cet exemple se déconnecte en mode silencieux de Exchange Online PowerShell ou de PowerShell de conformité de la 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 Exchange Online basée sur REST avec la valeur ConnectionId spécifiée. Toutes les autres connexions PowerShell distantes à Exchange Online PowerShell ou Conformité de la sécurité & 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 Exchange Online PowerShell basées sur REST qui utilisent les valeurs de préfixe spécifiées. Toutes les autres connexions PowerShell distantes à Exchange Online PowerShell ou Conformité de la sécurité & dans la même fenêtre Windows PowerShell sont également déconnectées.

Paramètres

-Confirm

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont 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 cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ConnectionId

Remarque : Ce paramètre est disponible dans la version 3.2.0 ou ultérieure du module.

Le paramètre ConnectionId spécifie les connexions d’API REST à déconnecter par ConnectionId. ConnectionId est une valeur GUID dans la sortie de l’applet de commande Get-ConnectionInformation qui identifie de façon unique une connexion, même si plusieurs connexions sont 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.

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

-ModulePrefix

Remarque : Ce paramètre est disponible dans la version 3.2.0 ou ultérieure du module.

Le paramètre ModulePrefix spécifie les connexions d’API REST à déconnecter par ModulePrefix. Lorsque vous utilisez le paramètre Prefix avec l’applet de commande Connect-ExchangeOnline, le texte spécifié est ajouté aux noms de toutes les applets de commande Exchange Online (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.

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

-WhatIf

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

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