Get-CsSipDomain
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zu den SIP-Domänen zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind. 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
Get-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSipDomain [-Filter <String>]
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 können Sie das Cmdlet New-CsSipDomain ausführen.
Das Cmdlet Get-CsSipDomain bietet die Möglichkeit, Informationen zu den SIP-Domänen zurückzugeben, die für die Verwendung in Ihrer Organisation autorisiert sind. Get-CsSipDomain identifiziert auch die Standard-SIP-Domäne für Ihre Organisation. Dies ist die Domäne, die von Microsoft Lync Server 2010 standardmäßig verwendet wird, wenn keine SIP-Domäne festgelegt ist.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-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 "Set-CsSipDomain"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) der SIP-Domäne, die zurückgegeben werden soll (z. B. "fabrikam.com"). Wenn weder dieser Parameter noch der Parameter "Filter" festgelegt ist, werden alle für die Verwendung in Ihrer Organisation autorisierten SIP-Domänen zurückgegeben. |
Filter |
Optional |
Zeichenfolge |
Ermöglicht die Verwendung von Platzhaltern beim Angeben der Identitätswerte der SIP-Domänen, die zurückgegeben werden sollen. Der Filterwert "*.org" gibt beispielsweise eine Auflistung aller autorisierten SIP-Domänen zurück, deren Identitätswert auf den Zeichenfolgenwert ".org" endet. |
Eingabetypen
Keine. Get-CsSipDomain akzeptiert keine weitergeleiteten Daten.
Rückgabetypen
Mit Get-CsSipDomain werden Instanzen des Objekts "Microsoft.Rtc.Management.Xds.SipDomain" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsSipDomain
In Beispiel 1 wird Get-CsSipDomain ohne Parameter aufgerufen. Dadurch werden Informationen zu allen SIP-Domänen zurückgegeben, die für die Verwendung in Ihrer Organisation konfiguriert sind.
-------------------------- Beispiel 2 --------------------------
Get-CsSipDomain -Identity fabrikam.com
Der Befehl in Beispiel 2 gibt Informationen für jede SIP-Domäne mit dem Identitätswert "fabrikam.com" zurück. Da die Identitätswerte von SIP-Domänen eindeutig sein müssen, wird mit diesem Befehl nie mehr als ein Element zurückgegeben.
-------------------------- Beispiel 3 --------------------------
Get-CsSipDomain -Filter "f*"
Mit dem vorstehenden Befehl werden Get-CsSipDomain und der Parameter "Filter" verwendet, um Informationen zu allen SIP-Domänen zurückzugeben, deren Identitätswert mit dem Buchstaben "f" beginnt. Beispiel: "fabrikam.com", "fabrikam.org", "fabrikam-users.com" etc.
-------------------------- Beispiel 4 --------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -eq $True}
Der Befehl in Beispiel 4 gibt Informationen zur Standard-SIP-Domäne zurück. Dazu wird zunächst Get-CsSipDomain ohne Parameter aufgerufen, um eine Auflistung aller SIP-Domänen zurückzugeben, die für die Verwendung in Ihrer Organisation konfiguriert wurden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die eine Domäne herausfiltert, deren Eigenschaft "IsDefault" den Wert "True" aufweist.