Disable-UMIPGateway
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-08-08
Mithilfe des Cmdlets Disable-UMIPGateway wird ein UM-IP-Gateway (Unified Messaging) deaktiviert.
Syntax
Disable-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Immediate <$true | $false>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Sie können mithilfe der Statusvariablen eines UM-IP-Gateways die für den IP-Gateway bestimmte Anrufannahme aktivieren oder deaktivieren. Mit dem Cmdlet Disable-UMIPGateway wird ein UM-IP-Gateway in Active Directory durch Änderung seiner Statusvariablen deaktiviert.
Damit Sie das Cmdlet Disable-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 deaktiviert wird. Dies ist die Verzeichnisobjekt-ID des UM-IP-Gateways. |
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 (Fully Qualified Domain Name, FQDN) des Domänencontrollers an, der diese Konfigurationsänderung in Active Directory schreibt. |
Immediate |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob der Unified Messaging-Server Anrufe, die diesem UM-IP-Gateway zugeordnet sind, sofort beendet oder wartet, bis die Verarbeitung der aktuellen Anrufe abgeschlossen ist. |
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
Das erste Beispiel deaktiviert den UM-IP-Gateway MyUMIPGateway. Der Gateway akzeptiert keine eingehenden Anrufe des IP-Gateways mehr.
Das zweite Beispiel deaktiviert den UM-IP-Gateway MyUMIPGateway und unterbricht sofort alle aktuellen Anrufe.
Disable-UMIPGateway -Identity MyUMIPGateway
Disable-UMIPGateway -Identity MyUMIPGateway -Immediate $true