Set-UMIPGateway (RTM)

Artikel
09/29/2014

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

Freigeben über