Set-UMIPGateway
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).
.gif "important") 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. |
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