Share via


Get-CsClientPolicy

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sui criteri client configurati per l'utilizzo nell'organizzazione. I criteri client consentono, tra altre cose, di determinare le funzionalità di Microsoft Lync 2010 a disposizione degli utenti. È ad esempio possibile assegnare ad alcuni utenti il diritto di trasferire i file, negando questo stesso diritto ad altri utenti.

Sintassi

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

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

Descrizione dettagliata

In Lync Server 2010 i criteri client sostituiscono le impostazioni di Criteri di gruppo in uso nelle versioni precedenti del prodotto. In Microsoft Office Communicator 2007 e Microsoft Office Communicator 2007 R2 la funzionalità Criteri di gruppo viene utilizzata per definire le azioni consentite agli utenti in Communicator e in altri client. Alcune impostazioni di Criteri di gruppo ad esempio stabiliscono se gli utenti possono o meno salvare una trascrizione delle rispettive sessioni di messaggistica istantanea, se possono o meno inserire emoticon o testo formattato nei messaggi istantanei e se nelle informazioni sulla presenza vengono incorporate le informazioni di Microsoft Outlook.

Nonostante l'utilità di Criteri di gruppo, questa tecnologia presenta tuttavia alcuni limiti se applicata a Lync Server 2010. Da un lato la funzionalità Criteri di gruppo è progettata per essere applicata in base al dominio o all'unità organizzativa e rende pertanto difficile assegnare i criteri a un gruppo di utenti più selezionato, ad esempio a tutti gli utenti che lavorano in un reparto specifico o a tutti quelli in possesso di una qualifica particolare. Dall'altro la funzionalità Criteri di gruppo viene applicata solo agli utenti che accedono al dominio e che effettuano l'accesso tramite un computer. Non viene applicata invece agli utenti che accedono al sistema su Internet o utilizzando un telefono cellulare. Ciò significa che lo stesso utente può avere esperienze diverse a seconda del dispositivo e della postazione utilizzati per l'accesso.

Per risolvere queste incongruenze, in Lync Server 2010 vengono utilizzati i criteri di gestione client anziché Criteri di gruppo. I criteri client vengono applicati ogni volta che un utente accede al sistema, indipendentemente dalla postazione e dal tipo di dispositivo utilizzati per l'accesso. I criteri client, analogamente ad altri criteri di Lync Server 2010, possono inoltre essere facilmente assegnati a gruppi selezionati di utenti. È anche possibile creare criteri personalizzati da assegnare a un singolo utente.

I criteri client possono essere configurati in ambito globale, di sito e per utente. Il cmdlet Get-CsClientPolicy consente di restituire informazioni su tutti i criteri client che sono stati configurati per l'utilizzo all'interno dell'organizzazione.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsClientPolicy i membri dei seguenti gruppi: RTCUniversalUserAdmins, 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 "Get-CsClientPolicy"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco dei criteri client da restituire. Per fare riferimento al criterio globale, utilizzare la seguente sintassi: -Identity global. Per fare riferimento a un criterio del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Per fare riferimento a un criterio per utente, utilizzare una sintassi simile alla seguente: -Identity SalesDepartmentPolicy.

Se si omette questo parametro, verranno restituiti tutti i criteri client configurati per utilizzo all'interno dell'organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly quando si indicano uno o più criteri da restituire. A esempio, per restituire tutti i criteri configurati nell'ambito del sito, utilizzare questa sintassi: -Filter "site:*". Per restituire una raccolta di tutti i criteri per utente, utilizzare la seguente sintassi: -Filter "tag:*".

LocalStore

Facoltativo

Parametro opzionale

Recupera i dati relativi ai criteri client dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno. Get-CsClientPolicy non accetta l'input da pipeline.

Tipi restituiti

Get-CsClientPolicy restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy.

Esempio

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

Get-CsClientPolicy

Nell'esempio precedente viene chiamato Get-CsClientPolicy senza includere altri parametri. In questo modo viene restituita una raccolta di tutti i criteri client configurati per l'utilizzo all'interno dell'organizzazione.

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

Get-CsClientPolicy -Identity SalesPolicy

Nell'esempio 2 viene utilizzato Get-CsClientPolicy per restituire i criteri client per utente con valore Identity SalesPolicy. Poiché le identità sono univoche, questo comando non restituirà mai più di un elemento.

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

Get-CsClientPolicy -Filter "tag:*"

Nell'esempio 3 viene utilizzato il parametro Filter per restituire tutti i criteri client configurati nell'ambito per utente. Il valore di filtro "tag:*" indica a Get-CsClientPolicy di restituire solo i criteri con valore Identity che inizia con il valore stringa "tag:".

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

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

Il comando precedente restituisce una raccolta di tutti i criteri client in cui la proprietà DisableSavingIM è impostata su True. A tale scopo, viene chiamato innanzitutto Get-CsClientPolicy senza alcun parametro per restituire una raccolta di tutti i criteri client configurati per l'utilizzo all'interno dell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona unicamente i criteri con proprietà DisableSavingIM uguale a True.

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

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -and $_.EnableIMAutoArchiving -eq $False}

Nell'esempio 5 vengono restituiti solo i criteri client che soddisfano due requisiti: la proprietà DisableSavingIM deve essere impostata su True, mentre la proprietà EnableIMAutoArchiving deve essere impostata su False. A tale scopo, nel comando viene chiamato innanzitutto Get-CsClientPolicy per restituire una raccolta di tutti i criteri client configurati per l'utilizzo all'interno dell'organizzazione. La raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona solo i criteri che soddisfano entrambi i seguenti requisiti: DisableSavingIM deve essere uguale a True ed EnableIMAutoArchiving deve essere uguale a False. L'operatore -and indica a Where-Object di selezionare solo gli oggetti che soddisfano tutti i requisiti specificati.

-------------------------- Esempio 6 --------------------------

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -or $_.EnableIMAutoArchiving -eq $False}

L'esempio 6 è una variazione del comando mostrato nell'esempio 5. Tuttavia, in questo caso, i criteri vengono selezionati finché soddisfano almeno uno dei seguenti requisiti: la proprietà DisableSavingIM è uguale a True e/o la proprietà EnableIMAutoArchiving è uguale a False. Per eseguire questa attività, nel comando viene chiamato innanzitutto Get-CsClientPolicy per restituire una raccolta di tutti i criteri client configurati per l'utilizzo all'interno dell'organizzazione. La raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona solo i criteri che soddisfano almeno uno dei seguenti requisiti: DisableSavingIM è uguale a True e/o EnableIMAutoArchiving è uguale a False. L'operatore -or indica a Where-Object di selezionare qualsiasi oggetto che soddisfi almeno una delle condizioni specificate.