Condividi tramite

  • Articolo

Get-CsClientVersionConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Recupera le informazioni sulla raccolta delle impostazioni di configurazione specificata della versione client in uso nell'organizzazione. Tali impostazioni determinano se Microsoft Lync Server 2010 deve o meno verificare il numero di versione di ogni applicazione client che accede al sistema. Se il filtro versione client è abilitato, l'applicazione client potrà o meno accedere al sistema in base alle impostazioni configurate nel criterio di versione client pertinente.

Sintassi

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

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

Descrizione dettagliata

Con Lync Server 2010 gli amministratori dispongono di uno spazio di manovra considerevole quando devono specificare il software client (e, ugualmente importante, il numero di versione del software) che gli utenti possono utilizzare per accedere al sistema. Ad esempio, non vi sono motivi tecnici che impongono agli utenti di accedere a Lync Server 2010 utilizzando Microsoft Lync 2010. Da un punto di vista tecnico, niente impedisce agli utenti di accedere utilizzando Microsoft Office Communicator 2007 R2.

Vi potrebbero essere invece motivi di carattere non tecnico per cui si preferisce che gli utenti non accedano tramite Office Communicator 2007 R2. Office Communicator 2007 R2 ad esempio non supporta tutte le caratteristiche e le funzionalità disponibili in Lync 2010. Agli utenti che effettuano l'accesso mediante Office Communicator 2007 R2 verrà pertanto offerta un'esperienza diversa rispetto agli utenti che per l'accesso utilizzano Lync 2010. Ciò può creare difficoltà per gli utenti; può inoltre creare difficoltà per il personale del supporto tecnico che deve fornire assistenza per varie applicazioni client diverse.

Se questo può costituire un problema per l'organizzazione, è possibile utilizzare il filtro versione client per specificare quali applicazioni client possono essere utilizzate per accedere a Lync Server 2010. Quando si installa Lync Server 2010, viene installato e abilitato un insieme globale di impostazioni di configurazione per la versione client. Tali impostazioni vengono utilizzate per determinare se il filtro versione client è abilitato o meno. Oltre alle impostazioni globali, anche le impostazioni di configurazione della versione client possono essere applicate nell'ambito del sito. In questo caso, le impostazioni del sito avranno la precedenza sulle impostazioni globali.

Il cmdlet Get-CsClientVersionConfiguration consente di recuperare le informazioni sulle impostazioni di configurazione della versione client attualmente in uso nell'organizzazione. Il cmdlet non restituisce informazioni su quali applicazioni client sono consentite e quali invece non lo sono. Per recuperare tali informazioni, utilizzare Get-CsClientVersionPolicy.

Anche tale configurazione della versione client non è una funzionalità di sicurezza. La tecnologia si basa su funzioni di auto-reporting da applicazioni client e non viene verificato se un'applicazione e il relativo numero di versione sono realmente quelli dichiarati.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsClientVersionConfiguration 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-CsClientVersionConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Indica l'identificatore univoco della raccolta di impostazioni di configurazione client da restituire. Per fare riferimento alle impostazioni globali, utilizzare la seguente sintassi: -Identity global. Per far riferimento a una raccolta configurata nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Non è possibile utilizzare caratteri jolly per specificare il parametro Identity. Se è necessario utilizzare caratteri jolly, includere invece il parametro Filter.

Se tale parametro non è specificato, Get-CsClientVersionConfiguration restituirà una raccolta di tutte le impostazioni di configurazione della versione client attualmente in uso nell'organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare caratteri jolly per restituire una o più raccolte di impostazioni di configurazione della versione client. Per restituire una raccolta di tutte le impostazioni configurate nell'ambito del sito, utilizzare la sintassi seguente: -Filter site:*. Per restituire una raccolta di tutte le impostazioni con valore stringa "EMEA" in un punto qualsiasi del parametro Identity (l'unica proprietà in base alla quale è possibile applicare il filtro), utilizzare la seguente sintassi: -Filter *EMEA*.

LocalStore

Facoltativo

Parametro opzionale

Recupera i dati di configurazione della versione client dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

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

Tipi restituiti

Get-CsClientVersionConfiguration restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration.

Esempio

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

Get-CsClientVersionConfiguration

Nel primo esempio viene chiamato Get-CsClientVersionConfiguration senza specificare ulteriori parametri. In questo modo, Get-CsClientVersionConfiguration restituirà una raccolta di tutte le impostazioni di configurazione della versione client attualmente in uso nell'organizzazione.

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

Get-CsClientVersionConfiguration -Identity site:Redmond

Nell'esempio precedente Get-CsClientVersionConfiguration restituisce tutte le impostazioni di configurazione della 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-CsClientVersionConfiguration -Filter "site:*"

Nell'esempio 3 vengono restituite tutte le impostazioni di configurazione della versione client applicate nell'ambito del sito. A tale scopo, vengono inclusi il parametro Filter e il valore di filtro "site:*". Tale valore di filtro indica a Get-CsClientVersionConfiguration di restituire solo le impostazioni il valore Identity inizia con il valore stringa "site:".

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

Get-CsClientVersionConfiguration | Where-Object {$_.Enabled -eq $False}

Nell'esempio precedente vengono restituite tutte le impostazioni di configurazione della versione client attualmente disabilitate. Per eseguire questa attività, nel comando viene innanzitutto utilizzato Get-CsClientVersionConfiguration per restituire una raccolta di tutte le impostazioni della versione client configurate per l'utilizzo nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che applica un filtro per limitare la raccolta alle impostazioni in cui la proprietà Enabled è uguale a False.