Disable-UMIPGateway

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-08-08

La cmdlet Disable-UMIPGateway désactive une passerelle IP de messagerie unifiée.

Syntaxe

Disable-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Immediate <$true | $false>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La variable d'état pour une passerelle IP de MU permet d'activer ou de désactiver des réponses aux appels destinées à la passerelle IP. La cmdlet Disable-UMIPGateway désactive une passerelle IP de messagerie unifiée dans le service d'annuaire Active Directory en modifiant sa variable d'état.

Pour exécuter la cmdlet Disable-UMIPGateway, vous devez utiliser un compte auquel le rôle Administrateur d'organisation Exchange a été délégué.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

Ce paramètre spécifie l'identificateur de la passerelle IP de MU en cours de désactivation. Il s'agit de l'identificateur d'objet d'annuaire pour la passerelle IP de MU.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre suspend le traitement par la commande et demande à l'administrateur de confirmer les actions que la commande va effectuer avant de continuer le traitement. La valeur par défaut est $true.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre spécifie le nom de domaine complet du contrôleur de domaine qui écrit ce changement de configuration dans Active Directory.

Immediate

Facultatif

System.Boolean

Ce paramètre indique si le serveur de messagerie unifiée abandonne immédiatement tous les appels associés à cette passerelle IP de messagerie unifiée ou attend l'achèvement du traitement des appels en cours.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, l'administrateur peut afficher les changements potentiels sans devoir les appliquer. La valeur par défaut est $true.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

Le premier exemple désactive une passerelle IP de messagerie unifiée nommée MyUMIPGateway et l’empêche d’accepter les appels entrants de la passerelle IP.

Le deuxième exemple de code désactive une passerelle IP de messagerie unifiée nommée MyIPGateway et déconnecte immédiatement tous les appels en cours.

Disable-UMIPGateway -Identity MyUMIPGateway

Disable-UMIPGateway -Identity MyUMIPGateway -Immediate $true