Set-UMIPGateway (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-07-12
Das Cmdlet Set-UMIPGateway wird zum Ändern der Konfigurationseinstellungen für einen UM-IP-Gateway (Unified Messaging) oder zum Zurückgeben einer Liste der Konfigurationseinstellungen verwendet, die auf einem bestimmten UM-IP-Gateway geändert werden können.
Syntax
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>]
Detaillierte Beschreibung
Das Cmdlet Set-UMIPGateway ändert die Konfigurationseinstellungen für einen bestimmten UM-IP-Gateway, z. B. die IP-Adresse für den IP-Gateway. Diese Änderungen umfassen z. B. das Erlauben ausgehender Anrufe sowie das Steuern der Kommunikation mit einer SIP-aktivierten IP-PBX-Ressource oder einem IP-Gateway.
Wichtig
Es ist möglich, dass Änderungen der UM-IP-Gatewayeinstellungen die Kommunikation zwischen Unified Messaging-Servern und dem SIP-aktivierten oder IP/PBX IP-Gateway unterbrechen. Änderungen an einem UM-IP-Gatewayobjekt sollten nur von einem Administrator durchgeführt werden, der das ganze Ausmaß der Auswirkungen von Konfigurationsänderungen am UM-IP-Gateway versteht.
Damit Sie das Cmdlet Set-UMIPGateway ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Organisationsadministrator
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter |
Dieser Parameter gibt den Bezeichner des UM-IP-Gateways an, der geändert wird. Dieser Parameter ist die Verzeichnisobjekt-ID des UM-IP-Gateways. |
Adresse |
Optional |
Microsoft.Exchange.Data.UMSmartHost |
Dieser Parameter gibt die IP-Adresse an, die auf dem IP-Gateway oder der für SIP (Session Initiation Protocol) aktivierten IP/PBX-Ressource (IP/Private Branch eXchange) konfiguriert ist. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen des Domänencontrollers anzugeben, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Cmdlet den Parameter DomainController hinzu. |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.UMIPGateway |
Dieser Parameter gibt den Eingabeparameter an, der den neuen IP-Gateway darstellt. |
Name |
Optional |
System.String |
Dieser Parameter gibt den Anzeigenamen an, der für den UM-IP-Gateway verwendet wird. Dieser Anzeigename darf maximal 64 Zeichen lang sein. |
OutcallsAllowed |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob dieses IP-Gatewayobjekt für ausgehende Anrufe verwendet wird. Dies beinhaltet keine Anrufübergaben. |
Port |
Optional |
System.Int32 |
Dieser Parameter gibt den IP-Port an, den das IP-Gateway oder die IP/PBX-Ressource überwacht. Standardmäßig handelt es sich um Port 5060. Der Bereich dieses Parameters ist 0 bis 65535. |
Simulator |
Optional |
System.Boolean |
Dieser Parameter gibt den Simulator an, der für den angezeigten UM-IP-Gateway verwendet wird. Ein Simulator ermöglicht einem Client das Herstellen einer Verbindung mit dem Unified Messaging-Server. Diese Verbindung wird normalerweise in der Anwendung Exchange-Testtelefon verwendet. |
Status |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.GatewayStatus |
Dieser Parameter gibt an, ob das UM-IP-Gateway aktiviert oder deaktiviert werden soll. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Im ersten Codebeispiel wird die IP-Adresse eines UM-IP-Gateways mit Namen MyUMIPGateway geändert.
Im zweiten Codebeispiel wird verhindert, dass das UM-IP-Gateway eingehende Anrufe empfängt und ausgehende Anrufe absetzt.
Im dritten Beispiel wird das UM-IP-Gateway als IP/VoIP-Simulator aktiviert.
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