Set-CsSipDomain
Letztes Änderungsdatum des Themas: 2012-03-27
Ermöglicht es Ihnen, Eigenschaftswerte für die SIP-Domänen in Ihrer Organisation zu ändern. 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
Set-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 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.
Es muss immer eine SIP-Domäne als Standarddomäne konfiguriert sein. Mit dem Cmdlet Set-CsSipDomain können Sie die Standard-SIP-Domäne ändern.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-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 |
Erforderlich |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) der SIP-Domäne, die als Standarddomäne konfiguriert werden soll. 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. Ist dieser Wert "True", wird die neue Domäne zur neuen Standarddomäne. Sie können diesen Wert nicht auf "False" festlegen, da sonst keine Standard-SIP-Domäne vorliegt. |
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. Set-CsSipDomain akzeptiert keine weitergeleiteten Daten.
Rückgabetypen
Set-CsSipDomain gibt keine Objekte oder Werte zurück. Mit dem Cmdlet werden stattdessen bestehende Instanzen des Objekts "Microsoft.Rtc.Management.Xds.SipDomain" geändert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsSipDomain -Identity fabrikam.com -IsDefault $True
Der Befehl in Beispiel 1 legt die SIP-Domäne "fabrikam.com" unter Verwendung des Parameters "IsDefault" und des Parameterwerts "$True" als Standard-SIP-Domäne fest. Beim Ausführen dieses Befehls wird "Fabrikam.com" zur Standarddomäne, und die zuvor als Standarddomäne dienende Domäne wird "heruntergestuft", denn es kann immer nur eine Standarddomäne geben.