Set-UMIPGateway
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-07-17
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>] [-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>]]
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 Zulassen ausgehender Anrufe sowie das Steuern der Kommunikation mit einer SIP-aktivierten (Session Initiation Protocol) 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 der SIP-aktivierten IP/PBX-Ressource oder dem 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 dem Konto die Rolle Exchange-Organisationsadministrator zugewiesen worden sein.
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. |
Address |
Optional |
Microsoft.Exchange.Data.UMSmartHost |
Dieser Parameter gibt die IP-Adresse an, die auf dem IP-Gateway oder der SIP-aktivierten IP-PBX-Ressource (Private Branch eXchange) konfiguriert ist. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Dieser Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt den Administrator, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Der Standardwert lautet "$true". |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Dieser Parameter gibt den vollqualifizierten Domänennamen (FQDN) des Domänencontrollers an, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt. |
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. |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
Dieser Parameter weist den Befehl an, die Aktionen zu simulieren, die für das Objekt ausgeführt würden. Durch Verwendung des Parameters WhatIf kann der Administrator die sich ergebenden Änderungen anzeigen, ohne diese Änderungen tatsächlich auszuführen. Der Standardwert lautet "$true". |
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 werden dem UM-IP-Gateway die Funktion als IP-Gateway-Simulator sowie die Verwendung mit dem Cmdlet Test-UMConnectivity oder der Anwendung Exchange UM Test Phone ermöglicht.
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