Condividi tramite

  • Articolo

Get-CsClientVersionPolicy

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sui client, ad esempio Microsoft Office Communicator 2007 R2, supportati nell'ambiente Microsoft Lync Server 2010 in uso. I criteri di versione client consentono di specificare quali client, come Office Communicator 2007 R2, saranno in grado di accedere al sistema Lync Server 2010 in uso.

Sintassi

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

Get-CsClientVersionPolicy [-Filter <String>] [-LocalStore <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 sua 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 Communicator 2007 R2 a 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é non supporta le stesse caratteristiche e funzionalità di Lync 2010. A causa di conflitti hardware o software, può tuttavia accadere che un 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 accedere da Communicator 2007 R2.

Il cmdlet Get-CsClientVersionPolicy consente di recuperare tutti i criteri di versione client attualmente in uso nell'organizzazione, nonché di visualizzare le singole regole che costituiscono ognuno di questi criteri.

È 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 loro 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 in uso 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 nell'organizzazione in uso 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 Get-CsClientVersionPolicy 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-CsClientVersionPolicy\b"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco per il criterio da restituire. Per restituire il criterio globale, utilizzare la sintassi seguente: -Identity global. Per restituire un criterio configurato nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond". Per restituire un criterio configurato nell'ambito del servizio, utilizzare una sintassi simile alla seguente: -Identity "Registrar:atl-cs-001.litwareinc.com". Il servizio Registrar è l'unico servizio che può ospitare un criterio di versione client.

I criteri possono essere configurati anche in ambito per utente. Per restituire uno di questi criteri, utilizzare una sintassi simile alla seguente: -Identity "SalesDepartmentPolicy".

Se questo parametro non viene incluso, verranno restituiti tutti i criteri di versione client configurati per l'utilizzo nell'organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly quando si specificano i criteri da recuperare. Ad esempio, questa sintassi restituisce tutti i criteri configurati in ambito sito: -Filter "site:*". Questa sintassi restituisce tutti i criteri configurati in ambito per utente: -Filter "tag:*".

Non è possibile utilizzare i parametri Filter e Identity nello stesso comando.

LocalStore

Facoltativo

Parametro opzionale

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

Tipi di input

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

Tipi restituiti

Get-CsClientVersionPolicy restituisce istanze dell'oggetto criterio Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersion.

Esempio

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

Get-CsClientVersionPolicy

Nel primo esempio il cmdlet Get-CsClientVersionPolicy viene chiamato senza specificare ulteriori parametri. In questo modo, Get-CsClientVersionPolicy restituirà una raccolta di tutti i criteri di versione client configurati per l'utilizzo nell'organizzazione.

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

Get-CsClientVersionPolicy -Identity site:Redmond

Nell'esempio precedente Get-CsClientVersionPolicy restituisce tutti i criteri di versione client con valore Identity site:Redmond. Poiché le identità devono essere univoche, il comando non restituirà mai più di un elemento.

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

Get-CsClientVersionPolicy -Filter site:*

Nell'esempio 3 vengono restituiti tutti i criteri di versione client configurati in ambito sito. A tale scopo, vengono inclusi il parametro Filter e il valore di filtro "site:*". Tale valore indica a Get-CsClientVersionPolicy di restituire solo i criteri il cui parametro Identity inizia con il valore stringa "site:".

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

Get-CsClientVersionPolicy | Select-Object -ExpandProperty Rules

Il comando utilizzato nell'esempio 4 visualizza le informazioni dettagliate sulle singole regole configurate per ogni criterio di versione client. A tale scopo, viene innanzitutto utilizzato Get-CsClientVersionPolicy per recuperare una raccolta di tutti i criteri di versione client configurati per l'utilizzo nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Select-Object, che utilizza il filtro ExpandProperty per espandere i valori della proprietà Rules. Quando tale proprietà è espansa, vengono visualizzate informazioni dettagliate su ciascuna regola, tra cui valori di proprietà come il numero di build, la versione principale e la versione secondaria.