Set-UMIPGateway (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-07-12
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>] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]
Set-UMIPGateway [-Address <UMSmartHost>] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]
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 IP-PBX compatible SIP.
Important : |
---|
Il est possible que des modifications des paramètres de la passerelle IP de MU perturbent la communication entre les serveurs de messagerie unifiée et la passerelle IP IP-PBX ou compatible 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 Annuaire pour la passerelle IP de MU. |
Adresse |
Facultatif |
Microsoft.Exchange.Data.UMSmartHost |
Ce paramètre spécifie l'adresse IP configurée sur la passerelle IP ou l'IP-PBX (IP/Private Branch eXchange) compatible SIP (Session Initiation Protocol). |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Pour spécifier le nom de domaine complet du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory, incluez le paramètre DomainController dans la cmdlet. |
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. |
Nom |
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. |
Types d'entrées
Types de renvois
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 MU d'opérer comme un simulateur IP/VoIP.
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