Set-UMIPGateway

Article
09/30/2014

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

Dernière rubrique modifiée : 2007-07-17

La cmdlet Set-UMIPGateway permet de modifier les paramètres de configuration d'une passerelle IP de messagerie unifiée (MU) unique ou de retourner une liste des paramètres de configuration pouvant être modifiés sur une passerelle IP de MU donnée.

Syntaxe

Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]

Set-UMIPGateway [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Set-UMIPGateway modifie les paramètres de configuration pour une passerelle IP de MU donnée, par exemple, l'adresse IP de la passerelle IP. Ces modifications incluent l'autorisation d'appels sortants et le contrôle des communications avec une passerelle IP ou un PBX IP à extension SIP (Session Initiation Protocol).

Important :
Il est possible que des modifications des paramètres de la passerelle IP de messagerie unifiée perturbent la communication entre les serveurs de messagerie unifiée et la passerelle IP ou le PBX IP à extension SIP. Les modifications de l'objet passerelle IP de MU doivent uniquement être effectuées par un administrateur qui comprend parfaitement les implications de l'apport de modifications de configuration à la passerelle IP de MU.

Il est possible que des modifications des paramètres de la passerelle IP de messagerie unifiée perturbent la communication entre les serveurs de messagerie unifiée et la passerelle IP ou le PBX IP à extension SIP. Les modifications de l'objet passerelle IP de MU doivent uniquement être effectuées par un administrateur qui comprend parfaitement les implications de l'apport de modifications de configuration à la passerelle IP de MU.

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

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 modification. Ce paramètre est l'identificateur d'objet d'annuaire pour la passerelle IP de MU.
Address	Facultatif	Microsoft.Exchange.Data.UMSmartHost	Ce paramètre spécifie l'adresse IP configurée sur la passerelle IP ou le PBX (Private Branch eXchange) IP à extension SIP.
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 le service d'annuaire Active Directory.
Instance	Facultatif	Microsoft.Exchange.Data.Directory.SystemConfiguration.UMIPGateway	Ce paramètre spécifie le paramètre d'entrée qui représente une nouvelle passerelle IP.
Name	Facultatif	System.String	Ce paramètre spécifie le nom complet utilisé pour la passerelle IP de MU. Le nom complet ne peut pas contenir plus de 64 caractères.
OutcallsAllowed	Facultatif	System.Boolean	Ce paramètre spécifie l'autorisation ou non d'utiliser cet objet passerelle IP pour les appels sortants. Cela ne concerne pas le transfert d'appels.
Port	Facultatif	System.Int32	Ce paramètre spécifie le port IP sur lequel la passerelle IP ou l'IP PBX écoute. Par défaut, il s'agit du port 5060. La plage pour ce paramètre s'étend de 0 à 65535.
Simulator	Facultatif	System.Boolean	Ce paramètre spécifie le simulateur utilisé pour la passerelle IP de MU affichée. Un simulateur permet à un client de se connecter au serveur de messagerie unifiée. Cette connexion est généralement utilisée dans l'application de test de téléphone Exchange.
Status	Facultatif	Microsoft.Exchange.Data.Directory.SystemConfiguration.GatewayStatus	Ce paramètre spécifie d'activer ou de désactiver la passerelle IP de MU.
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 de code modifie l'adresse IP d'une passerelle IP de MU nommée MyUMIPGateway.

Le deuxième exemple de code empêche la passerelle IP de MU d'accepter les appels entrants et empêche les appels sortants.

Le troisième exemple permet à la passerelle IP de messagerie unifiée de fonctionner comme simulateur de passerelle IP. Vous pouvez l'utiliser avec la cmdlet Test-UMConnectivity ou l'application de test de téléphone de messagerie unifiée d'Exchange.

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1 -Status 2 -OutcallsAllowed $false

Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true

Partager via