Remove-CsSipDomain
Letztes Änderungsdatum des Themas: 2012-03-27
Entfernt eine SIP-Domäne, die zuvor für die Verwendung in Ihrer Organisation konfiguriert wurde. SIP-Domänen sind zum Senden und Empfangen von SIP-Datenverkehr autorisierte Domänen und werden beim Zuweisen von SIP-Adressen zu Benutzern verwendet.
Syntax
Remove-CsSipDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Sie benötigen zwei Informationen, um SIP-Adressen für die Benutzer zu konfigurieren (und diesen die Verwendung von SIP-bezogener Software wie Microsoft Lync 2010 zu gestatten): eine Benutzer-ID (z. B. "Ken.Myer") und eine SIP-Domäne (z. B. "litwareinc.com"). Bei der zum Erstellen einer SIP-Adresse verwendeten SIP-Domäne muss es sich um eine in der Active Directory-Gesamtstruktur befindliche Domäne handeln, die zum Senden und Empfangen von SIP-Datenverkehr befugt ist. Angenommen, es gibt beispielsweise die Domänen "litwareinc.com", "fabrikam.com" und "contoso.com", aber nur "litwareinc.com" wurde als SIP-Domäne identifiziert. In diesem Fall können Sie keine SIP-Adresse wie "sip:Ken.Myer@fabrikam.com" oder "sip:Ken.Myer@contoso.com" verwenden, solange "fabrikam.com" und "contoso.com" nicht als gültige SIP-Domänen konfiguriert wurden. Dazu müssen Sie das Cmdlet New-CsSipDomain ausführen.
Die Autorisierung einer zuvor autorisierten SIP-Domäne kann mit dem Cmdlet Remove-CsSipDomain aufgehoben werden. Dieses Cmdlet entfernt die angegebene Domäne aus der Liste der genehmigten SIP-Domänen. Dabei ist jedoch zu beachten, dass die Standarddomäne nicht entfernt werden kann. Wenn dies erforderlich sein sollte, müssen Sie zunächst eine andere SIP-Domäne als Standarddomäne konfigurieren. Ist nur eine SIP-Domäne vorhanden, wird diese automatisch als Standarddomäne konfiguriert und kann nicht entfernt werden.
Darüber hinaus können Sie keine SIP-Domäne entfernen, der eine oder mehr SIP-Adressen zugewiesen sind. Sie können beispielsweise "Contoso.com" nicht als eine SIP-Domäne entfernen, wenn Ken Myer die SIP-Adresse "sip:kenmyer@contoso.com" zugewiesen ist. Um eine derzeit verwendete SIP-Adresse zu entfernen, müssen Sie zunächst allen Benutzern, deren SIP-Adressen diese Domäne enthalten, neue SIP-Adressen zuordnen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsSipDomain lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsSipDomain"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) der zu entfernenden SIP-Domäne: Beispiel: -Identity fabrikam.com. |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Microsoft.Rtc.Management.Xds.SipDomain-Objekt. Remove-CsSipDomain akzeptiert weitergeleitete Instanzen von SIP-Domänenobjekten.
Rückgabetypen
Keine. Mit Remove-CsSipDomain werden stattdessen vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.Xds.SipDomain" gelöscht.
Beispiel
-------------------------- Beispiel 1 --------------------------
Remove-CsSipDomain -Identity fabrikam.com
Mit dem vorstehenden Befehl wird die SIP-Domäne mit der Identität "fabrikam.com" aus der Liste der unterstützten Domänennamen entfernt. Beachten Sie, dass beim Ausführen dieses Befehls ein Fehler auftritt, wenn "fabrikam.com" die einzige SIP-Domäne ist, die derzeit innerhalb der Organisation verwendet wird, da die Topologie mindestens eine SIP-Domäne enthalten muss.
-------------------------- Beispiel 2 --------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -ne $True} | Remove-CsSipDomain
Der Befehl in Beispiel 2 löscht alle SIP-Domänen in der Organisation, mit Ausnahme der Standarddomäne. Hierzu ruft der Befehl zunächst Get-CsSipDomain auf, um eine Auflistung aller SIP-Domänen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Domänen herausfiltert, deren Eigenschaft "IsDefault" nicht den Wert "True" aufweist. Auswirkung: Die Standarddomäne wird herausgefiltert, und die übrigen Domänen werden dann an Remove-CsSipDomain weitergeleitet und gelöscht.