New-UMIPGateway
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-07-12
Das Cmdlet New-UMIPGateway erstellt einen neuen UM-IP-Gateway (Unified Messaging). Ein UM-IP-Gateway wird verwendet, um Unified Messaging-Server mit einem IP-Gateway oder einer SIP-aktivierten (Session Initiation Protocol) IP-PBX-Ressource zu verbinden.
Syntax
New-UMIPGateway -Name <String> -Address <UMSmartHost> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-TemplateInstance <PSObject>] [-UMDialPlan <UMDialPlanIdParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Das Cmdlet New-UMIPGateway erstellt einen neuen UM-IP-Gateway. Ein UM-IP-Gateway verfügt über einen organisationsweiten Geltungsbereich und verweist auf einen einzelnen physikalischen IP-Gateway. Der neue UM-IP-Gateway wird verwendet, um eine Verbindung mit einem IP-Gateway oder einer SIP-aktivierten IP/PBX-Ressource einzurichten.
Damit Sie das Cmdlet New-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 |
|---|---|---|---|
Address |
Erforderlich |
Microsoft.Exchange.Data.UMSmartHost |
Dieser Parameter gibt die IP-Adresse an, die auf dem IP-Gateway oder der SIP-aktivierten IP-PBX-Ressource konfiguriert ist. |
Name |
Erforderlich |
System.String |
Dieser Parameter gibt den Anzeigenamen für den UM-IP-Gateway an. Der Name für den neuen UM-IP-Gateway kann bis zu 64 Zeichen enthalten. |
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. |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
Dieser Parameter gibt an, dass das Cmdlet die Konfiguration eines vorhandenen Objekts verwendet, wenn es diesem Parameter übergeben wird, um eine identische Kopie des Objekts auf dem lokalen oder einem Zielserver zu erstellen. |
UMDialPlan |
Optional |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
Dieser Parameter gibt den UM-Wählplan an, der dem UM-IP-Gateway zugeordnet 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 ein neuer UM-IP-Gateway namens MyUMIPGateway erstellt. Dieser aktiviert einen Unified Messaging-Server für das Annehmen von Anrufen von einem IP-Gateway mit der IP-Adresse 10.10.10.1.
Im zweiten Codebeispiel wird ein neuer UM-IP-Gateway namens MyUMIPGateway erstellt. Dieser aktiviert einen Unified Messaging-Server für das Annehmen von Anrufen von einem IP-Gateway mit dem vollqualifizierten Domänennamen MyUMIPGateway.contoso.com.
New-UMIPGateway -Name MyUMIPGateway -Address 10.10.10.1
New-UMIPGateway -Name MyUMIPGateway -Address "MyUMIPGateway.contoso.com"