Set-CsRegistrar
Ultima modifica dell'argomento: 2012-03-26
Consente di modificare le proprietà di uno o più servizi di registrazione. I Registrar vengono utilizzati per autenticare richieste di accesso e per conservare informazioni sulla disponibilità e sullo stato degli utenti.
Sintassi
Set-CsRegistrar [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-BackupRegistrar <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-EnableAutomaticFailover <$true | $false>] [-FailbackDetectionInterval <TimeSpan>] [-FailureDetectionInterval <TimeSpan>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-Registrar <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-UserServer <String>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il servizio di registrazione è forse il componente più importante di Microsoft Lync Server 2010. Senza tale servizio, gli utenti non potrebbero infatti accedere al sistema e Lync Server 2010 non potrebbe tenere traccia degli utenti e del relativo stato corrente. Quando un utente accede a Lync Server, l'endpoint da cui viene eseguito l'accesso (sia che si tratti di un computer, di un telefono cellulare o di qualsiasi altro dispositivo) invia una richiesta REGISTER al server di registrazione che, a sua volta, risponde inviando al dispositivo client una richiesta di autenticazione delle credenziali dell'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 agevola l'instradamento dei messaggi da e verso l'utente.
Il cmdlet Set-CsRegistrar consente di modificare le proprietà di uno o più servizi di registrazione presenti nell'organizzazione. Consente ad esempio di modificare le impostazioni delle porte e di specificare l'azione da eseguire nel caso in cui un servizio di registrazione non sia più disponibile.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsRegistrar i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsRegistrar\b"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Identità XDS |
Posizione del servizio del Registrar da modificare. Ad esempio: -Identity "Registrar:atl-cs-001.litwareinc.com". È possibile omettere il prefisso "Registrar:" quando si specifica un servizio di registrazione. Ad esempio: -Identity "atl-cs-001.litwareinc.com". |
ArchivingServer |
Facoltativo |
Stringa |
Posizione del servizio del Server di archiviazione da associare al servizio di registrazione. Ad esempio: -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com". |
BackupRegistrar |
Facoltativo |
Stringa |
Posizione del servizio del Registrar da utilizzare se questo Registrar non è disponibile. Ad esempio: -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com". |
EdgeServer |
Facoltativo |
Stringa |
Posizione del servizio del Edge Server da associare al servizio di registrazione. Ad esempio: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com". |
EnableAutomaticFailover |
Facoltativo |
Booleano |
Se True, ogni volta che il Registrar primario non risulterà disponibile, verrà utilizzato quello di backup. Se False, il Registrar di backup non verrà utilizzato quando il Registrar primario non risulterà disponibile. Questo parametro influisce anche sugli utenti che si sono registrati con un Registrar di backup. Se questo parametro è impostato su True, questi utenti verranno cancellati dal Registrar di backup e registrati nuovamente sul Registrar primario se e quando questo Registrar diventerà disponibile. |
FailbackDetectionInterval |
Facoltativo |
TimeSpan |
Specifica per quanto tempo il sistema deve attendere prima di verificare se un servizio di registrazione non più disponibile è tornato di nuovo disponibile. Se EnableAutomaticFailover è stato impostato su True, il sistema eseguirà il "failover" sul servizio di registrazione di backup ogni volta che un servizio di registrazione non risulterà più disponibile. In altri termini, il sistema tenterà semplicemente di connettere al servizio di registrazione di backup gli utenti connessi al servizio di registrazione non funzionante. La proprietà FailbackDetectionInterval specifica quanto tempo il sistema deve attendere prima di verificare se il servizio di registrazione originale è tornato disponibile. In caso affermativo, Lync Server tenterà di eseguire il "failback" su tale servizio di registrazione. A seguito del failback, si tornerà al servizio di registrazione inizialmente in uso. In altri termini, gli utenti verranno di nuovo connessi al rispettivo servizio di registrazione originale. Il failback è esclusivamente un processo automatico. Non è pertanto possibile eseguire manualmente il failback da un servizio di registrazione all'altro. l'intervallo di rilevamento può essere impostato su un valore qualsiasi compreso fra 30 e 84.400 secondi (24 ore). Specificare tale intervallo nel formato ore:minuti:secondi. Nel seguente esempio l'intervallo viene impostato su 1 ora e 15 minuti: - FailbackDetectionInterval 01:15:00. Questo parametro può essere utilizzato solo se è stato specificato un servizio di registrazione di backup. |
FailureDetectionInterval |
Facoltativo |
TimeSpan |
Specifica l'intervallo di tempo che il sistema deve attendere prima di stabilire che un Registrar non è disponibile. Se EnableAutomaticFailover è stato impostato su True, il sistema tenterà di connettere gli utenti al servizio di registrazione di backup. l'intervallo di rilevamento può essere impostato su un valore qualsiasi compreso fra 30 e 84.400 secondi (24 ore). Specificare tale intervallo nel formato ore:minuti:secondi. Nel seguente esempio l'intervallo viene impostato su 1 ora e 15 minuti: - FailureDetectionInterval 01:15:00. Questo parametro può essere utilizzato solo se è stato specificato un servizio di registrazione di backup. |
MonitoringServer |
Facoltativo |
Stringa |
Posizione del servizio del Monitoring Server da associare al servizio di registrazione. Ad esempio: -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com". |
Registrar |
Facoltativo |
Stringa |
Posizione del servizio di registrazione. |
SipPort |
Facoltativo |
Numero intero |
Porta utilizzata per il traffico SIP (Session Initiation Protocol). |
SipHealthPort |
Facoltativo |
Stringa |
Porta utilizzata per il monitoraggio dell'integrità del server. |
SipServerTcpPort |
Facoltativo |
Stringa |
Porta di attesa SIP. Il valore predefinito è 5060. |
UserServer |
Facoltativo |
Stringa |
Posizione del servizio del Servizi utente da associare al servizio di registrazione. Ad esempio: -UserServer "UserServer:atl-cs-001.litwareinc.com". |
WebPort |
Facoltativo |
Numero intero |
Porta utilizzata per comunicare con i server Web. |
WebServer |
Facoltativo |
Stringa |
Posizione del servizio del server Web da associare al Registrar. Ad esempio: -WebServer "WebServer:atl-cs-001.litwareinc.com". |
Force |
Facoltativo |
Parametro opzionale |
Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'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
Nessuno. Set-CsRegistrar non accetta l'input da pipeline.
Tipi restituiti
Set-CsRegistrar non restituisce alcun oggetto o valore. Il comando piuttosto modifica le istanze esistenti dell'oggetto Microsoft.Rtc.Management.Xds.DisplayRegistrar.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -SipPort 5072
Il comando mostrato nell'esempio 1 imposta la porta SIP per il Registrar Registrar:atl-cs-001.litwareinc.com su 5072.
-------------------------- Esempio 2 --------------------------
Get-CsService -Registrar | ForEach-Object {Set-CsRegistrar -Identity $_.Identity -SipPort 5072}
Il comando precedente imposta su 5072 la porta SIP per tutti i servizi di registrazione presenti nell'organizzazione. A tale scopo, nel comando vengono innanzitutto utilizzati Get-CsService e il parametro Registrar per restituire una raccolta di tutti i servizi di registrazione attualmente in uso. La raccolta viene quindi inviata tramite pipe al cmdlet ForEach-Object, che individua i singoli servizi di registrazione presenti nella raccolta ed esegue il cmdlet Set-CsRegistrar per impostare su 5072 la porta SIP.
-------------------------- Esempio 3 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com" -EnableAutomaticFailover $True
Nell'esempio 3 vengono configurati sia un servizio di registrazione di backup (BackupRegistrar) sia il failover automatico (EnableAutomaticFailover) per il servizio di registrazione Registrar:atl-cs-001.litwareinc.com.