Condividi tramite

  • Articolo

Remove-CsUserServicesConfiguration

 

Ultima modifica dell'argomento: 2012-03-27

Consente di rimuovere una raccolta di impostazioni di configurazione di Servizi utente. Il servizio Servizi utente viene utilizzato per conservare le informazioni sulla presenza e gestire le conferenze.

Sintassi

Remove-CsUserServicesConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Microsoft Lync Server 2010 utilizza il servizio Servizi utente per mantenere le informazioni sulla presenza degli utenti e per gestire le riunioni e le conferenze. A loro volta, i cmdlet CsUserServicesConfiguration vengono utilizzati per gestire le impostazioni di configurazione di Servizi utente nell'ambito globale, del sito e del servizio. Si noti che l'unico servizio in grado di ospitare le impostazioni di configurazione di Servizi utente è il servizio stesso. Queste impostazioni consentono di specificare criteri quali il numero di contatti che un utente può avere; il numero di riunioni pianificate che un utente può avere in un dato momento; il tempo massimo in cui una data riunione può rimanere attiva.

Il cmdlet Remove-CsUserServicesConfiguration consente di rimuovere le impostazioni di configurazione dei Servizi utente applicate nell'ambito del sito o del servizio. Questo cmdlet può essere utilizzato anche nei confronti di raccolte 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à della raccolta globale verranno ripristinati i valori predefiniti. Ad esempio, se è stato modificato il valore MaxContacts nelle impostazioni globali su 500 e poi si esegue Remove-CsUserServciesConfiguration MaxContacts verrà ripristinato al valore predefinito di 250.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Remove-CsUserServicesConfiguration 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-CsUserServicesConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

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

Remove-CsUserServicesConfiguration può essere utilizzato anche per la raccolta globale. In questo caso, tuttavia, le impostazioni globali non verranno rimosse, ma verranno ripristinati i valori predefiniti di tutte le proprietà della raccolta globale.

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.UserServices.UserServicesSettings. Remove-CsUserServicesConfiguration accetta istanze inviate tramite pipeline dell'oggetto impostazioni di configurazione di Servizi utente.

Tipi restituiti

Nessuno. Invece, Remove-CsUserServicesConfiguration elimina le istanze esistenti dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.

Esempio

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

Remove-CsUserServicesConfiguration -Identity site:Redmond

Il comando riportato nell'Esempio 1 rimuove le impostazioni di configurazione dei Servizi utente per il sito Redmond (-Identity site:Redmond).

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

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

Nell'Esempio 2, vengono eliminate tutte le impostazioni di configurazione dei Servizi utente applicate nell'ambito del servizio. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsUserServicesConfiguration insieme al parametro Filter. Il valore del filtro "service:*" limita i dati restituiti alle impostazioni configurate nell'ambito del servizio (cioè, impostazioni che hanno Identity che inizia con i caratteri "service:"). Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsUserServicesConfiguration che elimina ogni elemento della raccolta.

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

Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 250} | Remove-CsUserServicesConfiguration

Il comando precedente rimuove tutte le impostazioni di configurazione dei Servizi utente che consento all'utente di avere più di 250 contatti. Per eseguire questa operazione, il comando prima utilizza il cmdlet Get-CsUserServicesConfiguration senza alcun parametro aggiuntivo; ciò restituisce una raccolta di tutte le impostazioni di configurazione di servizi per l'utente attualmente in uso. Questa raccolta viene poi inviata tramite pipe al cmdlet Where-Object che seleziona solo quelle impostazioni in cui il valore della proprietà MaxContacts è maggiore di 250. Queste impostazioni vengono poi inviate tramite pipe al cmdlet Remove-CsUserServicesConfiguration.