New-CsSipProxyRealm
Letztes Änderungsdatum des Themas: 2012-03-27
Zur Zuweisung des Standardbereichs (SIP-Kommunikationsdienst) zu einer Auflistung von Proxykonfigurationseinstellungen. Bereiche (auch bekannt als Schutzdomänen) werden zur Authentifizierung von Benutzerinformationen bei der Anmeldung genutzt.
Syntax
New-CsSipProxyRealm -RealmChoice <IRealmChoice>
Detaillierte Beschreibung
Mit Proxyservern können Benutzer außerhalb des internen Netzwerks auf Ressourcen im internen Netzwerk zugreifen. Jeder Proxyserver muss einem Bereich zugeordnet sein. Diese Bereiche, die auch als Schutzdomänen bezeichnet werden, geben an, wo die Anmeldeinformationen eines Benutzers verarbeitet werden. Standardmäßig verwendet Microsoft Lync Server 2010 den SIP-Kommunikationsdienst als Standardbereich; Sie können den von einem Proxyserver verwendeten Bereich jedoch ändern. Die Cmdlets New-CsSipProxyUseDefault und New-CsSipProxyCustom dienen zum Ändern des von einem Proxyserver verwendeten Bereichs. Diese Änderungen können auch mit New-CsSipProxyRealm durchgeführt werden. Da bei diesem Cmdlet jedoch ein weiterer Schritt erforderlich ist, sind die anderen beiden Cmdlets zum Ändern des von einem Proxyserver verwendeten Bereichs eventuell eher angebracht.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet New-CsSipProxyRealm lokal auszufü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-CsSipProxyRealm"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
RealmChoice |
Erforderlich |
SipProxy.IRealmChoice-Objekt |
Ein Objekt, das den von einem Proxyserver zu verwendenden Bereich repräsentiert. Die Eigenschaft "RealmChoice" muss entweder mit dem Cmdlet New-CsSipProxyUseDefault oder mit dem Cmdlet New-CsSipProxyCustom erstellt werden. |
Eingabetypen
Keine. New-CsSipProxyRealm akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit New-CsSipProxyRealm werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Realm" erstellt.
Beispiel
-------------------------- Beispiel 1 --------------------------
$x = New-CsSipProxyUseDefault
$y = New-CsSipProxyRealm -RealmChoice $x
Mit den Befehlen in Beispiel 1 wird der Standardbereich (SIP-Kommunikationsdienst) der Variablen "$y" zugewiesen. Hierzu ruft der erste Befehl das Cmdlet New-CsSipProxyUseDefault auf, um ein SipProxy.UseDefault-Objekt zu erstellen. Dieses Objekt wird in der Variablen "$x" gespeichert.
Im zweiten Befehl wird "$x" als Parameterwert für New-CsSipProxyRealm und den Parameter "RealmChoice" verwendet. Dies wiederum führt zur Erstellung eines neuen Proxybereichsobjekts, das in der Variablen "$y" gespeichert wird.
-------------------------- Beispiel 2 --------------------------
$x = New-CsSipProxyCustom -CustomValue "Litwareinc Communications Service"
$y = New-CsSipProxyRealm -RealmChoice $x
Mit den Befehlen in Beispiel 2 wird ein benutzerdefinierter Bereich (Litwareinc Communications Service) der Variablen "$y" zugewiesen. Hierzu ruft der erste Befehl das Cmdlet New-CsSipProxyCustom auf, um ein SipProxy.Custom-Objekt zu erstellen. Dieses Objekt wird in der Variablen "$x" gespeichert.
Im zweiten Befehl wird "$x" zusammen mit dem Cmdlet New-CsSipProxyRealm und dem Parameter "RealmChoice" verwendet, um ein neues benutzerdefiniertes Bereichsobjekt zu erstellen.