Condividi tramite

  • Articolo

Get-CsRegistrarConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce le informazioni sulle impostazioni di configurazione della registrazione attualmente in uso nella propria organizzazione. I servizi di registrazione vengono utilizzati per autenticare richieste di accesso e per conservare informazioni sulla disponibilità e sullo stato degli utenti.

Sintassi

Get-CsRegistrarConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsRegistrarConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Il servizio di registrazione è forse il componente più importante di Microsoft Lync Server 2010; infatti, senza il servizio di registrazione gli utenti non sarebbero in grado di accedere al sistema e Lync Server 2010 non sarebbe in grado di tenere traccia degli utenti e del loro stato attuale. Quando un utente accede a Lync Server, l'endpoint da cui l'utente accede invia una richiesta REGISTER al servizio di registrazione; il server, a sua volta, risponde richiedendo al dispositivo client le credenziali di autenticazione. Se il client viene accettato (cioè fornisce credenziali valide), l'utente viene autenticato e le informazioni relative all'endpoint, quali indirizzo IP, porta e nome utente, vengono salvate nel database di registrazione. Quando un utente si disconnette, queste informazioni vengono eliminate dal database. Nel periodo tra l'accesso e la disconnessione, il servizio di registrazione mantiene aggiornate le informazioni sullo stato e contribuisce all'instradamento dei messaggi da e verso l'utente.

Le impostazioni di configurazione del servizio di registrazione vengono utilizzate per gestire gli endpoint e le sottoscrizioni agli endpoint; queste impostazioni possono essere applicate in ambito globale, del sito o del servizio. Le impostazioni nell'ambito del servizio possono essere utilizzate solo per il servizio di registrazione. Il cmdlet Get-CsRegistrarConfiguration consente di recuperare le informazioni su tutte le raccolte di configurazioni della registrazione attualmente in uso nella propria organizzazione.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsRegistrarConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Identificatore univoco delle impostazioni di configurazione della registrazione da ottenere. Per ottenere le impostazioni globali, utilizzare la seguente sintassi: -Identity global. Per ottenere le impostazioni configurate nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Per ottenere le impostazioni a livello di servizio, utilizzare una sintassi simile alla seguente: -Identity service:Registrar:atl-cs-001.litwareinc.com.

Se questo parametro viene omesso, il cmdlet Get-CsRegistrarConfiguration restituisce tutte le impostazioni di configurazione della registrazione attualmente in uso nella propria organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per ottenere una o più raccolte di impostazioni di configurazione della registrazione. Ad esempio, per restituire tutte le impostazioni configurate nell'ambito del sito, utilizzare la seguente sintassi: -Filter "site:*". Per restituire tutte le impostazioni configurate nell'ambito del servizio, utilizzare la seguente sintassi: -Filter "service:*".

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i dati sulle impostazioni di configurazione della registrazione dalla copia locale di archivio di gestione centrale invece che da archivio di gestione centrale.

Tipi di input

Nessuno. Get-CsRegistrarConfiguration non accetta input tramite pipeline.

Tipi restituiti

Get-CsRegistrarConfiguration restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Esempio

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

Get-CsRegistrarConfiguration

Il comando riportato nell'Esempio 1 restituisce una raccolta di tutte le impostazioni di configurazione della registrazione attualmente in uso nella propria organizzazione.

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

Get-CsRegistrarConfiguration -Identity site:Redmond

L'Esempio 2 restituisce una singola raccolta di impostazioni di configurazione della registrazione: le impostazioni configurate per il sito Redmond (-Identity site:Redmond).

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

Get-CsRegistrarConfiguration -Filter "service:*"

Nell'Esempio 3, vengono restituite le informazioni su tutte le impostazioni di configurazione della registrazione assegnate all'ambito del servizio. Per ottenere questo risultato, il comando utilizza il parametro Filter e il valore del filtro "service:*"; questo valore del filtro consente di limitare i dati restituiti a quelle impostazioni la cui identità inizia con il valore di stringa "service:" inizia con la stringa "service:".

-------------------------- Esempio 4 --------------------------

Get-CsRegistrarConfiguration | Where-Object {$_.EnableDHCPServer -eq $True}

L'Esempio 4 restituisce le informazioni sulle impostazioni di configurazione della registrazione che consentono l'utilizzo di server DHCP per registrare i client. Per eseguire questa operazione, il comando prima utilizza il cmdlet Get-CsRegistrarConfiguration senza alcun parametro aggiuntivo; ciò restituisce una raccolta di tutte le impostazioni di configurazione della registrazione attualmente in uso. La raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona solo le impostazioni in cui EnableDHCPServer equivale a True.

-------------------------- Esempio 5 --------------------------

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

Nel comando precedente vengono restituite le informazioni su tutte le impostazioni di configurazione della registrazione che consentono più di otto endpoint per utente. A tale scopo, viene innanzitutto utilizzato Get-CsRegistrarConfiguration per restituire una raccolta di tutte le impostazioni di configurazione della registrazione utilizzate nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le impostazioni la cui proprietà MaxEndpointsPerUser è maggiore di 8.