New-CsSipDomain
Letztes Änderungsdatum des Themas: 2012-03-27
Erstellt eine neue SIP-Domäne für die Verwendung in Ihrer Organisation. 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
New-CsSipDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-IsDefault <$true | $false>] [-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 autorisiert 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.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-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 "New-CsSipDomain"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) für die neue SIP-Domäne. Beispiel: -Identity fabrikam.com. |
IsDefault |
Optional |
Boolescher Wert |
Gibt an, ob die Domäne die Standard-SIP-Domäne darstellt, d. h. die von Lync Server 2010 verwendete Domäne, wenn der Domänenname nicht ausdrücklich angegeben ist. Lautet dieser Wert "True", wird die neue Domäne darüber hinaus zur neuen Standarddomäne. Der Standardwert für "IsDefault" lautet "False". Wenn Sie die neue Domäne nicht als Standarddomäne definieren möchten, geben Sie den Parameter einfach nicht an. |
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
Keine. New-CsSipDomain akzeptiert keine weitergeleiteten Daten.
Rückgabetypen
Mit New-CsSipDomain werden neue Instanzen des Objekts "Microsoft.Rtc.Management.Xds.SipDomain" erstellt.
Beispiel
-------------------------- Beispiel 1 -------------------------
New-CsSipDomain -Identity fabrikam.com
Der Befehl in Beispiel 1 erstellt eine neue SIP-Domäne mit dem Identitätswert "fabrikam.com".
-------------------------- Beispiel 2 -------------------------
New-CsSipDomain -Identity fabrikam.com -IsDefault $True
Mit dem vorstehenden Befehl wird eine neue SIP-Domäne mit dem Namen "fabrikam.com" erstellt und als Standard-SIP-Domäne definiert. Durch das Definieren von "fabrikam.com" als Standarddomäne wird gleichzeitig die zuvor als Standard-SIP-Domäne verwendete Domäne "herabgestuft". Der Grund hierfür ist, dass nur eine Standard-SIP-Domäne definiert werden kann.