Condividi tramite

  • Articolo

Set-CsClientVersionConfiguration

 

Ultima modifica dell'argomento: 2012-03-27

Consente di modificare la raccolta specificata di impostazioni di configurazione della versione client. Le impostazioni di configurazione della versione client determinano se Microsoft Lync Server 2010 controlla o no il numero di versione di ciascuna applicazione client che si collega al sistema. Se il filtraggio della versione client è attivo la possibilità per quella applicazione client di accedere al sistema sarà basata sulla impostazione configurata negli appositi criteri di versione client.

Sintassi

Set-CsClientVersionConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsClientVersionConfiguration [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Lync Server 2010 consente agli amministratori una considerevole libertà di azione nello specificare il software client (e, ugualmente importante, il numero della versione di quel software) che gli utenti possono utilizzare per accedere al sistema. Ad esempio, non esistono motivi tecnici che impongano ad un utente di accedere a Lync Server 2010 utilizzando Microsoft Lync 2010; dal punto di vista tecnico, non esiste nulla che impedisca ad un utente di accedere utilizzando Microsoft Office Communicator 2007 R2.

D'altra parte, potrebbero esserci motivi non tecnici per cui si preferisce che gli utenti non accedano utilizzando Office Communicator 2007 R2. Ad esempio, Office Communicator 2007 R2 non supporta tutte le funzionalità e caratteristiche che si trovano in Lync 2010; con il risultato che utenti che accedono con Office Communicator 2007 R2 avranno esperienze diverse dagli utenti che accedono utilizzando Lync 2010. Questo può creare difficoltà agli utenti; può anche creare difficoltà al personale del supporto tecnico che deve fornire supporto a svariate applicazioni client.

Se questo rappresenta un problema, allora si può utilizzare il filtraggio delle versioni 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 della versione client. Queste impostazioni vengono utilizzate per determinare se il filtraggio della versione client è attivo o meno. Oltre alle impostazioni globali, le impostazioni di configurazione della versione del client possono essere applicate nell'ambito del sito; in questo caso, le impostazioni del sito hanno la precedenza sulle impostazioni globali.

Il cmdlet Set-CsClientVersionConfiguration consente di modificare una raccolta esistente di impostazioni di configurazione della versione client.

Si noti che la configurazione della versione client non è una funzionalità di sicurezza. La tecnologia si affida all'autosegnalazione da parte delle applicazioni client e non tenta di verificare che un'applicazione sia veramente quell'applicazione e che il numero della versione sia effettivamente quello indicato.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsClientVersionConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsClientVersionConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Indica l'identificatore univoco delle impostazioni di configurazione della versione client da modificare. Per modificare le impostazioni globali, utilizzare la seguente sintassi: -Identity global. Per modificare le impostazioni assegnate nell'ambito del sito, utilizzare una sintassi simile alla seguente: "site:Redmond".

Se non viene incluso questo parametro, Set-CsClientVersionConfiguration configurerà automaticamente le impostazioni globali.

Instance

Facoltativo

Oggetto ClientVersionPolicy

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

DefaultAction

Facoltativo

Stringa

Indica l'azione da intraprendere se un utente tenta di accedere da un'applicazione client il cui numero di versione non viene trovato nell'appropriato criterio di versione client. DefaultAction deve essere impostato su uno dei seguenti valori:

Allow. All'applicazione client viene consentito l'accesso.

AllowWithUrl. All'applicazione client viene consentito l'accesso. In aggiunta, verrà visualizzata all'utente una finestra di messaggio con incluso l'URL di una pagina Web da dove quell'utente può scaricare un'applicazione client approvata. L'URL per questa pagina Web deve essere specificato come valore della proprietà DefaultUrl.

Block. All'applicazione client viene impedito l'accesso.

BlockWithUrl. All'applicazione client viene impedito l'accesso. Tuttavia, nella finestra del messaggio "Accesso negato" visualizzata all'utente verrà incluso l'URL di una pagina Web da dove quell'utente può scaricare un'applicazione client approvata. L'URL per questa pagina Web deve essere specificato come valore della proprietà DefaultUrl.

Questa proprietà viene ignorata se la proprietà Enable è impostata su False. Quando la proprietà Enabled è impostata su False non viene effettuato nessun tipo di filtraggio versione client.

DefaultUrl

Facoltativo

Stringa

Specifica l'URL della pagina Web da cui gli utenti possono scaricare un'applicazione client approvata. Se tale parametro è specificato e se DefaultAction è impostato su BlockWithUrl, l'URL verrà indicato nella finestra di messaggio "Accesso negato" visualizzata ogni volta che un utente tenta di accedere da un'applicazione client non supportata.

Enabled

Facoltativo

Booleano

Indica se il filtraggio versione client è abilitato o disabilitato. Se la proprietà Enabled è impostata su True, il server controllerà il numero di versione di ciascuna applicazione client che tenta di accedere, il server poi consentirà o negherà l'accesso basandosi sui criteri di versione client appropriati. Se la proprietà Enabled è impostata su False sarà consentito l'accesso a qualsiasi applicazione client in grado di effettuarlo.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Booleano

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration. Set-CsClientVersionConfiguration accetta le istanze dell'oggetto configurazione della versione client inviate tramite pipeline.

Tipi restituiti

Set-CsClientVersionConfiguration non restituisce alcun oggetto o valore. Il cmdlet configura invece istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration.

Esempio

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

Set-CsClientVersionConfiguration -Identity site:Redmond -Enabled $False

Nell'Esempio 1 viene utilizzato Set-CsClientVersionConfiguration per modificare la raccolta di impostazioni con Identity "site:Redmond". In questo caso, il parametro Enabled è impostato su False per disabilitare le impostazioni di configurazione della versione client.

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

Get-CsClientVersionConfiguration | Set-CsClientVersionConfiguration -DefaultURL "https://litwareinc.com/csclients"

Nel precedente esempio, la proprietà DefaultUrl viene modificata per tutte le impostazioni di configurazione della versione client in uso nell'organizzazione. Per ottenere questo risultato, il comando prima utilizza Get-CsClientVersionConfiguration senza alcun parametro aggiuntivo per ottenere tutte le impostazioni di configurazione della versione client. Quella informazione viene poi inviata tramite pipe al cmdlet Set-CsClientVersionConfiguration che imposta la proprietà DefaultUrl per ciascuna raccolta di configurazioni su https://litwareinc.com/csclients.

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

Get-CsClientVersionConfiguration | Where-Object {$_.DefaultAction -eq "Block"} | Set-CsClientVersionConfiguration -DefaultAction "BlockWithUrl" -DefaultURL "https://litwareinc.com/csclients"

Nell'Esempio 3, vengono apportate modifiche a tutte impostazioni di configurazione delle versioni client dove il valore corrente di DefaultAction è impostato su Block. Per ottenere tale risultato, con il comando viene innanzitutto utilizzato Get-CsClientVersionConfiguration per restituire una raccolta di tutte le impostazioni di configurazione della versione client attualmente in uso. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo gli elementi in cui la proprietà DefaultAction è uguale a "Block". La raccolta così filtrata viene a sua volta inviata tramite pipe al cmdlet Set-CsClientVersionConfiguration che esegue due azioni su ciascun elemento nella raccolta: 1) imposta DefaultAction su BlockWithUrl e 2) imposta DefaultUrl su https://litwareinc.com/csclients.