Remove-CsClientPolicy

 

Ultima modifica dell'argomento: 2012-03-26

Consente di rimuovere un criterio client esistente. Tra l'altro, i criteri client consentono di stabilire le funzionalità di Microsoft Lync 2010 disponibili per gli utenti; ad esempio, è possibile consentire ad alcuni utenti di trasferire i file mentre ad altri no.

Sintassi

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

Descrizione dettagliata

In Lync Server 2010, i criteri client sostituiscono le impostazioni di Criteri di gruppo utilizzate nelle versioni precedenti del prodotto. In Microsoft Office Communicator 2007 e Microsoft Office Communicator 2007 R2, Criteri di gruppo consentiva di stabilire le operazioni che gli utenti potevano eseguire con Communicator e altri client; ad esempio, erano disponibili delle impostazioni di Criteri di gruppo per stabilire se gli utenti potevano o meno salvare una trascrizione delle sessioni di messaggistica istantanea, se le informazioni da Microsoft Outlook dovevano essere incluse nelle informazioni sulla presenza e se gli utenti potevano includere o meno emoticon o testo formattato nei messaggi istantanei.

Tuttavia, per quanto utile, la tecnologia Criteri di gruppo presenta comunque delle limitazioni se applicata a Lync Server 2010. Da un lato, Criteri di gruppo è stato concepito per essere applicato per singolo dominio o per singola unità organizzativa e pertanto risulta difficile applicare i criteri ad un gruppo di utenti specifici (ad esempio, tutti gli utenti che lavorano in un determinato reparto o tutti gli utenti con una determinata qualifica). Dall'altro, Criteri di gruppo viene applicato solo agli utenti che accedono al dominio tramite un computer; Criteri di gruppo non viene applicato agli utenti che accedono a Lync Server 2010 su Internet o che accedono al sistema utilizzando un telefono cellulare. Ciò significa che lo stesso utente può avere un'esperienza diversa in base al dispositivo e al luogo da cui esegue l'accesso.

Per risolvere questi problemi, in Lync Server 2010 vengono utilizzati criteri client invece di Criteri di gruppo. I criteri client vengono applicati ogni volta che un utente accede al sistema, indipendentemente dal dispositivo e dal luogo da cui viene eseguito l'accesso. I criteri client, così come altri criteri di Lync Server 2010, possono inoltre essere applicati a gruppi di utenti selezionati. È anche possibile creare un criterio personalizzato che viene assegnato a un singolo utente.

È possibile configurare i criteri client nell'ambito globale, del sito o di un singolo utente. I criteri configurati nell'ambito del sito o di un singolo utente possono essere successivamente eliminati utilizzando il cmdlet Remove-CsClientPolicy. Il cmdlet Remove-CsClientPolicy può anche essere eseguito per il criterio globale. In questo caso, tuttavia, il criterio globale non verrà rimosso, in quanto i criteri globali non possono essere rimossi. Tuttavia, per tutte le proprietà del criterio globale verranno ripristinati i valori predefiniti.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco del criterio client da rimuovere. Per "rimuovere" il criterio globale, utilizzare la seguente sintassi: -Identity global. Si noti che non è possibile eliminare un criterio globale. Ciò che accade è che per tutte le proprietà di quel criterio globale verranno ripristinati i valori predefiniti. Per eliminare criteri del sito, usare una sintassi simile alla seguente: -Identity "site:Redmond". Per eliminare criteri per utente, usare una sintassi simile alla seguente: -Identity "SalesDepartmentPolicy". Non è possibile utilizzare caratteri jolly quando si specifica l'identità di un criterio.

Force

Facoltativo

Parametro opzionale

Se questo parametro è presente, il criterio verrà rimosso automaticamente anche se è attualmente assegnato a un utente. Se questo parametro non è presente, il cmdlet Remove-CsClientPolicy non rimuoverà automaticamente un criterio per un singolo utente che è assegnato ad almeno un utente. Verrà invece visualizzato un messaggio che richiede di confermare la rimozione del criterio. Per procedere con l'operazione e rimuovere il criterio, è necessario rispondere Sì (premendo il tasto Y).

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.Policy.Client.ClientPolicy. Remove-CsClientPolicy accetta le istanze dell'oggetto criterio client inviate tramite pipeline.

Tipi restituiti

Remove-CsClientPolicy non restituisce alcun valore. Il cmdlet elimina le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy.

Esempio

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

Remove-CsClientPolicy -Identity SalesPolicy

Nell'Esempio 1, il cmdlet Remove-CsClientPolicy viene utilizzato per eliminare il criterio client con Identity SalesPolicy.

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

Get-CsClientPolicy -Filter "tag:*" | Remove-CsClientPolicy

Nell'Esempio 2, i cmdlet Get-CsClientPolicy e Remove-CsClientPolicy vengono utilizzati per eliminare tutti i criteri client configurati nell'ambito di ogni singolo utente. Il comando utilizza il cmdlet Get-CsClientPolicy e il parametro Filter per ottenere una raccolta di tutti i criteri client configurati nell'ambito del singolo utente; il valore del filtro "tag:*" fa in modo che il cmdlet Get-CsClientPolicy restituisca solo i dati relativi a quei criteri client la cui identità inizia con la stringa "tag:". La raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsClientPolicy che rimuove ogni criterio nella raccolta.

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

Get-CsClientPolicy | Where-Object {$_.EnableAppearOffline -eq $True} | Remove-CsClientPolicy

Il comando precedente elimina tutti i criteri client in cui la proprietà EnableAppearOffline è impostata su True. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsClientPolicy senza parametri aggiuntivi; il cmdlet restituisce una raccolta di tutti i criteri client configurati per l'utilizzo nell'organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo quei criteri in cui la proprietà EnableAppearOffline è uguale a True. Questa raccolta filtrata viene a sua volta inviata tramite pipe al cmdlet Remove-CsClientPolicy che elimina ogni criterio nella raccolta.