New-CsSipProxyRealm
Ultima modifica dell'argomento: 2012-03-27
Assegna l'area di autenticazione predefinita (Servizio di comunicazioni SIP) a una raccolta di impostazioni di configurazione del proxy. Le aree di autenticazione, anche note come domini di protezione, vengono utilizzate per autenticare le credenziali degli utenti durante l'accesso.
Sintassi
New-CsSipProxyRealm -RealmChoice <IRealmChoice>
Descrizione dettagliata
I server proxy consentono agli utenti che si trovano al di fuori della rete interna di accedere alle risorse disponibili nella rete interna. Ogni server proxy deve essere associato a un'area di autenticazione, anche nota come dominio di protezione, che indica quando elaborare le credenziali di accesso di un utente. Per impostazione predefinita, in Microsoft Lync Server 2010 viene utilizzato il Servizio di comunicazioni SIP quale area di autenticazione predefinita. Tuttavia, è possibile modificare l'area di autenticazione utilizzata da un server proxy. I cmdlet New-CsSipProxyUseDefault e New-CsSipProxyCustom consentono di modificare l'area di autenticazione utilizzata da un server proxy. Queste modifiche possono anche essere eseguite utilizzando New-CsSipProxyRealm. Tuttavia, poiché questo cmdlet richiede un passaggio aggiuntivo, può essere consigliabile utilizzare gli altri due cmdlet ogni volta che è necessario modificare l'area di autenticazione utilizzata da un server proxy.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet New-CsSipProxyRealm in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipProxyRealm"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
RealmChoice |
Obbligatorio |
Oggetto SipProxy.IRealmChoice |
Oggetto che rappresenta l'area di autenticazione che deve essere utilizzata da un server proxy. È necessario creare RealmChoice utilizzando il cmdlet New-CsSipProxyUseDefault o il cmdlet New-CsSipProxyCustom. |
Tipi di input
Nessuno. New-CsSipProxyRealm non accetta input inviato tramite pipe.
Tipi restituiti
New-CsSipProxyRealm consente di creare nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Realm.
Esempio
-------------------------- Esempio 1 ------------------------
$x = New-CsSipProxyUseDefault
$y = New-CsSipProxyRealm -RealmChoice $x
Con i comandi mostrati nell'esempio 1 viene assegnata l'area di autenticazione predefinita (Servizio di comunicazioni SIP) a una variabile denominata $y. Per questo scopo, il primo comando chiama New-CsSipProxyUseDefault per creare un oggetto SipProxy.UseDefault, che viene memorizzato in una variabile denominata $x.
Nel secondo comando, la variabile $x viene utilizzata come valore per il parametro New-CsSipProxyRealm e il parametro RealmChoice. In questo modo viene creato un nuovo oggetto area di autenticazione del proxy che viene memorizzato in una variabile denominata $y.
-------------------------- Esempio 2 ------------------------
$x = New-CsSipProxyCustom -CustomValue "Litwareinc Communications Service"
$y = New-CsSipProxyRealm -RealmChoice $x
Con i comandi mostrati nell'esempio 2 viene assegnata l'area di autenticazione personalizzata (Servizio di comunicazioni Litwareinc) a una variabile denominata $y. Per questo scopo, il primo comando chiama New-CsSipProxyCustom per creare un oggetto SipProxy.Custom (che utilizza il Servizio di comunicazioni CustomValue Litwareinc), che viene memorizzato in una variabile denominata $x.
Nel secondo comando viene utilizzata la variabile $x insieme al cmdlet New-CsSipProxyRealm e al parametro RealmChoice per creare un nuovo oggetto area di autenticazione personalizzata.