New-CsClientPolicyEntry

Sintassi

New-CsClientPolicyEntry -Name <String> -Value <String>

Descrizione dettagliata

I criteri client sono il principale meccanismo utilizzato da Lync Server 2010 per gestire software client quale Microsoft Lync 2010. Quando si crea o si configura un criterio client, sono disponibili numerose opzioni. È ad esempio possibile specificare se utilizzare o meno foto in Lync 2010, se consentire o meno l'utilizzo di emoticon nei messaggi istantanei e se le trascrizioni delle sessioni di messaggistica istantanea devono essere salvate automaticamente da Lync 2010. Tali opzioni riguardano molte delle impostazioni relative ai client che gli amministratori devono gestire.

Potrebbero, tuttavia, non essere incluse tutte le impostazioni che gli amministratori devono gestire. Per maggiore flessibilità ed estendibilità, i criteri client presentano quindi una proprietà denominata PolicyEntry che può essere impostata su più valori e consente agli amministratori di aggiungere nuove opzioni di gestione non chiamate esplicitamente nei criteri client. Ad esempio, prima del rilascio di Lync Server, i tester della versione beta hanno avuto la possibilità di aggiungere un'opzione di feedback in Lync 2010. Tale opzione è stata aggiunta come nuova voce di criterio e creata utilizzando New-CsClientPolicyEntry.

Si noti che non è possibile creare arbitrariamente nuove voci di criterio né si deve presumere che tali voci possano gestire Lync 2010 o altre applicazioni client. Sarà invece necessario attendere da Microsoft la notifica dei nomi e dei valori utilizzabili per creare nuove voci di criterio client.

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

Parametri

Tipi di input

Nessuno. New-CsClientPolicyEntry does not accept pipelined input.

Tipi restituiti

New-CsClientPolicyEntry crea nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Client.PolicyEntryType.

Esempio

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

$x = New-CsClientPolicyEntry -Name "OnlineFeedbackURL" -Value "http://www.litwareinc.com/feedback"

$y = Get-CsClientPolicy -Identity global
$y.PolicyEntry.Add($x)

Set-CsClientPolicy -Instance $y

I comandi dell'esempio 1 mostrano come aggiungere una nuova voce di criterio al criterio client globale. Nell'esempio viene infatti aggiunta a Lync 2010 una nuova opzione di feedback. L'esempio ha tuttavia solo finalità puramente dimostrative. Non presumere di poter eseguire questi comandi e aggiungere un'opzione di feedback analoga nella propria copia di Lync 2010.

Per aggiungere la nuova voce di criterio, nel primo comando dell'esempio viene utilizzato New-CsClientPolicyEntry per creare una voce con nome OnlineFeedbackURL e valore http://www.litwareinc.com/feedback. L'oggetto voce di criterio risultante viene archiviato nella variabile denominata $x.

Nel secondo comando viene utilizzato Get-CsClientPolicy per creare un riferimento oggetto ($y) al criterio client globale. Una volta creato il riferimento oggetto, viene utilizzato il metodo Add per aggiungere la nuova voce di criterio alla proprietà PolicyEntry. Se PolicyEntry presenta già una o più voci, il nuovo valore verrà semplicemente aggiunto alla fine di tale raccolta.

Nell'ultimo comando dell'esempio viene infine utilizzato Set-CsClientPolicy per scrivere le modifiche nel criterio globale effettivo. Se Set-CsClientPolicy non viene chiamato, le modifiche saranno presenti solo in memoria e scompariranno non appena si chiude la sessione di Windows PowerShell oppure si elimina la variabile $x.

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

$x = New-CsClientPolicyEntry -Name "OnlineFeedbackURL" -Value "http://www.litwareinc.com/feedback"
Set-CsClientPolicy -Identity global -PolicyEntry $x

L'esempio 2 rappresenta una variazione dei comandi mostrati nell'esempio 1. In questo caso, la nuova voce di criterio sostituisce tutti gli elementi correntemente presenti nella proprietà PolicyEntry del criterio globale. A tale scopo, con il primo comando dell'esempio viene creata una nuova voce di criterio archiviata in una variabile denominata $x. Nel secondo comando viene quindi utilizzato Set-CsClientPolicy per impostare su $x il valore della proprietà PolicyEntry. Al termine dell'esecuzione del comando, l'unico elemento nella proprietà PolicyEntry sarà la nuova voce. Tutti gli elementi contenuti in tale proprietà prima della chiamata di Set-CsClientPolicy saranno stati sostituiti dalla nuova voce.

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

$y = Get-CsClientPolicy -Identity global
$y.PolicyEntry.RemoveAt(0)

Set-CsClientPolicy -Instance $y 

Nell'esempio 3 viene mostrato come rimuovere una voce di criterio client dal criterio globale. A tale scopo, con il primo comando dell'esempio viene recuperato il criterio client globale e tali informazioni vengono archiviate in una variabile denominata $y.

Dopo che il criterio globale è stato richiamato, nel secondo comando viene utilizzato il metodo RemoveAt() per eliminare la prima voce di tale criterio. La voce di criterio da rimuovere è indicata dal relativo numero di indice. La prima voce ha come numero di indice 0, la seconda 1 e così via. La sintassi RemoveAt(0) significa perciò che verrà rimossa la prima voce di criterio.

Non appena la voce di criterio viene rimossa dall'istanza in memoria del criterio globale, viene chiamato il cmdlet Set-CsClientPolicy per scrivere tali modifiche nell'istanza effettiva del criterio client globale.

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

Set-CsClientPolicy -Identity global -PolicyEntry $Null

Con il comando mostrato nell'esempio 4 vengono rimosse tutte le voci di criterio client configurate per il criterio globale. A tale scopo, viene utilizzato il parametro PolicyEntry e il relativo valore viene impostato su null ($Null).

Vedere anche

Ulteriori risorse

New-CsClientPolicy
Set-CsClientPolicy