Condividi tramite

  • Articolo

Remove-CsRegistrarConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Consente di rimuovere 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

Remove-CsRegistrarConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<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 Remove-CsRegistrarConfiguration consente di rimuovere le impostazioni di configurazione della registrazione applicate nell'ambito del sito o del servizio. Si noti che in realtà nessuna delle registrazioni viene eliminata o disinstallata; più semplicemente, vengono rimosse le impostazioni di configurazione che regolano quelle registrazioni. Se queste impostazioni non esistono nell'ambito del sito o del servizio, la registrazione verrà gestita utilizzando le impostazioni globali.

È possibile eseguire il cmdlet Remove-CsRegistrarConfiguration anche con le impostazioni di configurazione globali. In questo caso, tuttavia, le impostazioni non verranno rimosse, in quanto le impostazioni globali non possono essere eliminate. Ciò che accade è che per tutte le proprietà di quella raccolta globale verranno ripristinati i valori predefiniti. Ad esempio, se per la proprietà MinEndpointExpiration è stato specificato il valore 500, tale valore verrà riportato al valore predefinito 300.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Remove-CsRegistrarConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: 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 "Remove-CsRegistrarConfiguration e"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

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

Si noti che è possibile eseguire il cmdlet Remove-CsRegistrarConfiguration anche con le impostazioni globali (-identity global). In questo caso, tuttavia, le impostazioni globali non verranno rimosse, ma verranno ripristinati i valori predefiniti di tutte le proprietà della raccolta globale.

Force

Obbligatorio

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. Remove-CsRegistrarConfiguration accetta le istanze inviate tramite pipeline dell'oggetto impostazioni per la registrazione.

Tipi restituiti

Nessuno. Invece, Remove-CsRegistrarConfiguration consente di eliminare le istanze esistenti dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Esempio

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

Remove-CsRegistrarConfiguration -Identity site:Redmond

Il comando riportato nell'Esempio 1 consente di eliminare le impostazioni di configurazione della registrazione assegnate al sito Redmond. Quando queste impostazioni vengono eliminate, le registrazioni del sito Redmond utilizzeranno automaticamente le impostazioni di registrazione globali.

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

Get-CsRegistrarConfiguration -Filter "service:*" | Remove-CsRegistrarConfiguration

Il comando precedente consente di eliminare tutte impostazioni di configurazione della registrazione assegnate all'ambito del servizio. Per ottenere questo risultato, il comando prima utilizza Get-CsRegistrarConfiguration e il parametro Filter; il valore del filtro "service:*" restituisce solo i dati relativi a quelle impostazioni la cui identità inizia con i caratteri "service:" La raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsRegistrarConfiguration che elimina ogni elemento presente nella raccolta.

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

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

Nell'Esempio 3, vengono eliminate tutte le impostazioni di configurazione della registrazione nelle quali la proprietà EnableDHCPServer è impostata su True. 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. Questa raccolta filtrata viene a sua volta inviata tramite pipe al cmdlet Remove-CsRegistrarConfiguration che elimina ogni elemento della raccolta.