Condividi tramite

  • Articolo

Set-CsRegistrarConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Modifica i valori delle proprietà in una raccolta esistente di impostazioni di configurazione del servizio di registrazione. I servizi di registrazione vengono utilizzati per autenticare richieste di accesso e per conservare informazioni sulla disponibilità e sullo stato degli utenti.

Sintassi

Set-CsRegistrarConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsRegistrarConfiguration [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Il servizio di registrazione è forse il componente più importante in Microsoft Lync Server 2010; dopo tutto, senza un servizio di registrazione, gli utenti non potrebbero collegarsi al sistema e Lync Server 2010 non potrebbe tenere traccia degli utenti e del loro stato corrente. Quando un utente accede a Lync Server, l'endpoint da cui l'utente sta eseguendo l'accesso invia una richiesta REGISTER al server di registrazione, il quale, a sua volta, risponde inviando al dispositivo client una richiesta di verifica delle credenziali utente. Se il client supera la richiesta di autenticazione (presentando un set di credenziali valido), l'utente viene autenticato e le informazioni sull'endpoint (quali indirizzo IP, porta e nome utente) vengono registrate nel database di registrazione. Quando un utente si disconnette, queste informazioni vengono rimosse dal database. Tra l'accesso e la disconnessione, il servizio di registrazione mantiene aggiornate le informazioni sullo stato e aiuta a instradare i messaggi da e verso l'utente.

Le impostazioni di configurazione del servizio di registrazione sono utilizzate per gestire gli endpoint e le sottoscrizioni agli endpoint; le impostazioni possono essere applicate nell'ambito globale, del sito o del servizio. Le impostazioni nell'ambito del servizio sono utilizzate solo con il servizio di registrazione. È possibile utilizzare il cmdlet Set-CsRegistrarConfiguration per modificare una o tutte le raccolte di configurazione del servizio di registrazione attualmente in uso nell'organizzazione.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-CsRegistrarConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsRegistrarConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco per le impostazioni di configurazione del servizio di registrazione da modificare. Per modificare le impostazioni globali, utilizzare la sintassi seguente: -Identity global. Per modificare le impostazioni configurate nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Per modificare le impostazioni a livello del servizio, utilizzare una sintassi simile alla seguente: -Identity service:Registrar:atl-cs-001.litwareinc.com. Le impostazioni del servizio di registrazione possono essere applicate solo al servizio stesso. Se si tenta di applicare queste impostazioni a un altro servizio viene visualizzato un messaggio di errore.

Instance

Facoltativo

Oggetto RegistrarSettings

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

DefaultEndpointExpiration

Facoltativo

Numero intero

All'accesso, gli endpoint possono richiedere un timeout di scadenza, che specifica l'intervallo per cui un endpoint può rimanere connesso al sistema prima di dover contattare il server e richiedere un'estensione. La proprietà DefaultEndpointExpiration rappresenta il timeout di scadenza per i client che non richiedono un valore di timeout specifico.

DefaultEndpointExpiration deve essere compreso tra 300 (5 minuti) e 900 (15 minuti). Il valore predefinito è 600 (10 minuti).

EnableDHCPServer

Facoltativo

Booleano

Indica se gli endpoint possono utilizzare i server DHCP per individuare un servizio di registrazione. Se l'impostazione è True, i client invieranno un messaggio DHCP Inform al primo avvio; il server DHCP risponderà inviando il nome di dominio completo di un servizio di registrazione utilizzabile per l'accesso dell'utente.

MaxEndpointExpiration

Facoltativo

Numero intero

All'accesso, gli endpoint possono richiedere un timeout di scadenza, che specifica l'intervallo per cui un endpoint può rimanere connesso al sistema prima di dover contattare il server e richiedere un'estensione. La proprietà MaxEndpointExpiration rappresenta il tempo massimo che può essere concesso ai client. Ad esempio, se il tempo massimo è impostato su 600 secondi e un client richiede un intervallo di timeout di 800 secondi, al client viene assegnato il periodo di scadenza massimo, 600 secondi.

MaxEndpointExpiration deve essere compreso tra 300 (5 minuti) e 900 (15 minuti). Il valore predefinito è 900.

MaxEndpointsPerUser

Facoltativo

Numero intero

Indica il numero massimo di endpoint che un utente può connettere contemporaneamente al sistema. Ad esempio, un utente connesso a Lync Server 2010 sia da un computer sia da un telefono cellulare utilizza due endpoint. La proprietà MaxEndPointsPerUser deve essere impostata su un valore compreso tra 1 e 64, inclusi. Il valore predefinito è 8.

MinEndpointExpiration

Facoltativo

Numero intero

All'accesso, gli endpoint possono richiedere un timeout di scadenza, che specifica l'intervallo per cui un endpoint può rimanere connesso al sistema prima di dover contattare il server e richiedere un'estensione. La proprietà MinEndpointExpiration rappresenta il tempo minimo che può essere concesso ai client. Ad esempio, se il tempo minimo è impostato su 600 secondi e un client richiede un intervallo di timeout di 200 secondi, al client viene assegnato il periodo di scadenza minimo, 600 secondi.

MinEndpointExpiration deve essere compreso tra 300 (5 minuti) e 900 (15 minuti). Il valore predefinito è 300.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings. Set-CsRegistrarConfiguration consente di accettare le istanze da pipeline dell'oggetto impostazioni del servizio di registrazione.

Tipi restituiti

Set-CsRegistrarConfiguration non restituisce alcun oggetto o valore. Il cmdlet, invece, consente di configurare le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Esempio

-------------------------- Esempio 1 --------------------------

Set-CsRegistrarConfiguration -Identity site:Redmond -EnableDHCPServer $True

Con il comando precedente vengono modificate le impostazioni di configurazione del servizio di registrazione applicate al sito Redmond (-Identity site:Redmond). In questo esempio, il valore della proprietà EnableDHCPServer è impostato su True.

-------------------------- Esempio 2 --------------------------

Get-CsRegistrarConfiguration | Where-Object {$_.MaxEndpointsPerUser -gt 8} | Set-CsRegistrarConfiguration -MaxEndpointsPerUser 8

Con l'esempio 2, vengono modificate le impostazioni di configurazione del servizio di registrazione che consentono gli utenti con più di 8 endpoint. Per ottenere questo risultato, il comando chiama per prima cosa Get-CsRegistrarConfiguration senza parametri per restituire una raccolta di tutte le impostazioni di configurazione del servizio di registrazione in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe a Where-Object, che recupera solo le impostazioni in cui la proprietà MaxEndpointsPerUser è maggiore (-gt) di 8. Infine, la raccolta filtrata viene inviata tramite pipe a Set-CsRegistrarCollection, che imposta il numero massimo di endpoint per ogni elemento nella raccolta su 8.

-------------------------- Esempio 3 --------------------------

Get-CsRegistrarConfiguration -Filter "site:*"| Set-CsRegistrarConfiguration -EnableDHCPServer $False

Il comando illustrato nell'esempio 3 consente di disabilitare la registrazione client utilizzando DHCP per ogni sito nell'organizzazione che ospita una raccolta di impostazioni di configurazione della funzione di registrazione. A tale scopo, nel comando viene chiamato Get-CsRegistrarConfiguration con il parametro Filter. Il valore di filtro "site:*" limita i dati restituiti alle impostazioni configurate nell'ambito del sito. La raccolta viene quindi inviata tramite pipe a Set-CsRegistrarConfiguration, che utilizza il parametro EnableDHCPServer e il valore di parametro $False per impedire ai client di utilizzare un server DHCP per individuare una funzione di registrazione.