Condividi tramite

  • Articolo

Grant-CsClientVersionPolicy

 

Ultima modifica dell'argomento: 2012-03-23

Assegna i criteri di versione client all'ambito globale, sito, servizio o per utente. I criteri di versione client consentono di specificare quali client, come Microsoft Office Communicator 2007 R2, saranno in grado di accedere al sistema Microsoft Lync Server 2010 in uso.

Sintassi

Grant-CsClientVersionPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

I criteri di versione client rappresentano una raccolta di regole di versione client. Tali regole, a loro volta, vengono utilizzate per stabilire a quali applicazioni client è consentito l'accesso a Lync Server 2010. Quando un utente tenta di accedere a Lync Server 2010, la relativa applicazione client invia un'intestazione SIP al server. In questa intestazione sono contenute informazioni dettagliate sull'applicazione, inclusi versione principale, versione secondaria e numero di build del software. In seguito, le informazioni sulla versione contenute nell'intestazione SIP vengono controllate a fronte di una raccolta di regole della versione client per verificare se alcune di queste regole si riferiscono a quella particolare applicazione. Se tale regola esiste, Lync Server 2010 eseguirà l'azione specificata dalla regola. La regola ad esempio potrebbe indicare a Lync Server 2010 di consentire l'accesso, di bloccarlo o di autorizzarlo e quindi di aggiornare l'applicazione client all'ultima versione, ad esempio da Office Communicator 2007 R2 a Microsoft Lync 2010, senza intervento dell'utente.

I criteri di versione client possono essere applicati nell'ambito globale, nell'ambito del sito, nell'ambito del servizio (solo servizio di registrazione) o nell'ambito per utente e offrono una notevole flessibilità nello stabilire quali applicazioni client possono essere utilizzate per accedere al sistema. È ad esempio possibile decidere di impedire agli utenti di accedere a Lync Server 2010 utilizzando Communicator 2007 R2 perché questa versione precedente dell'applicazione client non supporta le stesse caratteristiche e funzionalità di Lync 2010. A causa di conflitti hardware o software, può tuttavia accadere che un determinato gruppo di utenti non possa eseguire l'aggiornamento a Lync 2010. In questo caso, è possibile creare una regola separata e un criterio di versione client distinto per consentire a tali utenti di effettuare l'accesso da Communicator 2007 R2.

Il cmdlet Grant-CsClientVersionPolicy consente di assegnare criteri di versione client a singoli utenti. Quando si crea un criterio per utente, questo non viene automaticamente assegnato. L'assegnazione non viene effettuata finché non si chiama Grant-CsClientVersionPolicy per assegnare esplicitamente il criterio a un utente o a un insieme di utenti.

È importante notare che i criteri di versione client non si applicano agli utenti federati, i quali invece sono vincolati dai criteri di versione client utilizzati nella propria organizzazione. Si supponga ad esempio che un utente federato utilizzi il client A, un client consentito dall'organizzazione federata. Finché tale organizzazione federata consentirà l'utilizzo del client A, l'utente sarà in grado di comunicare con l'organizzazione avvalendosi del client in questione. Lo stesso avverrà anche se il criterio di versione client blocca l'utilizzo del client A. I criteri di versione client applicati nella propria organizzazione non hanno la priorità sui criteri di versione client utilizzati in un'organizzazione federata.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Parametro ID utente

Indica l'identità dell'account utente a cui assegnare i criteri. Le identità utente possono essere specificate con uno dei quattro formati riportati di seguito: 1) l'indirizzo SIP dell'utente, 2) il nome dell'entità utente (UPN, User Principal Name), 3) il nome di dominio e il nome di accesso dell'utente nel formato dominio\accesso (ad esempio, litwareinc\davidegarghentini), 4) il nome visualizzato Active Directory dell'utente (ad esempio, Davide Garghentini). È possibile fare riferimento alle identità utente anche utilizzando il nome distinto Active Directory dell'utente.

È inoltre possibile utilizzare il carattere jolly asterisco (*) quando si utilizza il nome visualizzato come valore Identity dell'utente. L'identità "* Smith" restituisce, ad esempio, tutti gli utenti il cui nome visualizzato termina con il valore stringa " Smith".

PolicyName

Obbligatorio

Stringa

Il "Nome" del criterio da assegnare. PolicyName corrisponde all'identità del criterio meno l'ambito del criterio (il prefisso "tag:"). Un criterio con valore Identity tag:Redmond ad esempio dispone di un valore PolicyName uguale a Redmond, mentre un criterio con valore Identity tag:RedmondClientVersionPolic dispone di un valore PolicyName uguale a RedmondClientVersionPolicy. Per annullare l'assegnazione di un criterio per utente precedentemente assegnato a un utente, impostare PolicyName su un valore Null ($Null).

DomainController

Facoltativo

Stringa

Consente di specificare un controller di dominio a cui connettersi durante l'assegnazione dei criteri. Se il parametro non è incluso, il cmdlet utilizzerà il primo controller di dominio disponibile.

PassThru

Facoltativo

Parametro opzionale

Se presente, il cmdlet passerà l'oggetto (o gli oggetti) utente attraverso la pipeline di Windows PowerShell. Per impostazione predefinita, Grant-CsClientVersionPolicy non passa oggetti attraverso la pipeline.

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

Valore stringa oppure oggetto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Grant-CsClientVersionPolicy accetta l'input da pipeline di valori stringa che rappresentano l'identità di un account utente. Il cmdlet accetta inoltre l'input da pipeline di oggetti utente.

Tipi restituiti

Per impostazione predefinita, Grant-CsClientVersionPolicy non restituisce oggetti o valori. Se tuttavia si include il parametro PassThru, il cmdlet restituirà le istanze dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

Esempio

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

Grant-CsClientVersionPolicy -Identity "Ken Myer" -PolicyName "RedmondClientVersionPolicy"

Nell'esempio 1, i criteri di versione client RedmondClientVersionPolicy sono assegnati all'utente Davide Garghentini.

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

Get-CsUser -LdapFilter "l=Redmond" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

Il comando mostrato nell'esempio 2 assegna i criteri di versione client RedmondClientVersionPolicy a tutti gli utenti che lavorano nella città di Redmond. Per eseguire questa operazione, nel comando vengono innanzitutto utilizzati Get-CsUser e il parametro LdapFilter per recuperare la raccolta di account utente appropriata. Il valore filtro "l=Redmond" (dove la lettera elle minuscola "l" corrisponde al nome dell'attributo LDAP che indica la "località") limita il recupero dei dati agli utenti che lavorano nella città di Redmond. La raccolta viene quindi inviata tramite pipe a Grant-CsClientVersionPolicy, che assegna il criterio specificato a ciascun utente nella raccolta.

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

Get-CsUser -OU "ou=Redmond,ou=North America,dc=litwareinc,dc=com" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

Nell'esempio 3 il criterio di versione client RedmondClientVersionPolicy viene assegnato a tutti gli utenti di un'unità organizzativa (OU) specifica. Per eseguire questa attività, il comando chiama innanzitutto Get-CsUser e il parametro OU. Il valore del parametro rappresenta il nome distinto dell'unità organizzativa ai cui utenti deve essere assegnato il criterio di versione client (ou=Redmond,ou=North America,dc=litwareinc,dc=com). Una volta recuperati gli account utente, la raccolta viene inviata tramite pipe a Grant-CsClientVersionPolicy, che assegna RedmondClientVersionPolicy a ciascuno degli utenti.

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

Get-CsUser -Filter {VoicePolicy -eq "RedmondVoicePolicy"} | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

Il comando precedente assegna il criterio di versione client RedmondClientVersionPolicy a tutti gli utenti a cui era stato precedentemente assegnato il criterio vocale RedmondVoicePolicy. A tale scopo, il comando chiama innanzitutto Get-CsUser insieme al parametro Filter. Il valore di filtro {VoicePolicy -eq "RedmondVoicePolicy"} assicura che vengano restituiti solo gli account utente con proprietà VoicePolicy uguale a "RedmondVoicePolicy". Gli account utente ottenuti vengono quindi inviati tramite pipe a Grant-CsClientVersionPolicy e viene loro assegnato il criterio di versione client RedmondClientVersionPolicy.

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

Get-CsUser | Grant-CsClientVersionPolicy -PolicyName $Null

Nell'esempio 5 per tutti gli utenti dell'organizzazione viene annullata l'assegnazione dei criteri di versione client per utente precedentemente assegnati. A tale scopo, nel comando viene innanzitutto utilizzato Get-CsUser per restituire una raccolta di tutti gli utenti dell'organizzazione che sono stati abilitati per Lync Server. La raccolta viene quindi inviata tramite pipe a Remove-CsClientVersionPolicy, che rimuove tutti i criteri di versione client per utente assegnati a tali utenti. Questa operazione viene eseguita impostando il valore di parametro PolicyName su $null.