Condividi tramite

  • Articolo

Set-CsClientVersionPolicy

 

Ultima modifica dell'argomento: 2012-03-26

Modifica un criterio di versione client esistente. I criteri di versione client consentono di specificare quali client, come Microsoft Office Communicator 2007 R2, saranno autorizzati ad accedere al sistema Microsoft Lync Server 2010 in uso.

Sintassi

Set-CsClientVersionPolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Rules <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsClientVersionPolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Rules <PSListModifier>] [-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, il server 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 oppure di autorizzarlo e quindi di aggiornare l'applicazione client all'ultima versione, ad esempio da 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é 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 effettuare l'accesso da Communicator 2007 R2.

I criteri di versione client possono essere modificati in qualsiasi momento. Modificare un criterio di versione client significa in genere aggiungere nuove regole, eliminare regole esistenti o modificare le proprietà di una regola esistente, ad esempio modificando un'azione della regola da Allow a Block. Queste modifiche possono essere effettuate mediante il cmdlet Set-CsClientVersionPolicy. Risulterà probabilmente più semplice apportare queste modifiche utilizzando invece il cmdlet CsClientVersionPolicyRule.

Set-CsClientVersionPolicy tuttavia consente di copiare facilmente un intero insieme di regole da un criterio di versione client a un altro. Per informazioni dettagliate, vedere la sezione degli esempi in questo argomento della Guida.

È 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 Set-CsClientVersionPolicy 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 "Set-CsClientVersionPolicy\b"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco per il criterio da modificare. Per modificare il criterio globale, utilizzare la sintassi seguente: -Identity global. Per modificare un criterio configurato nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond". Per modificare 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.

Con questo cmdlet è possibile modificare anche i criteri per utente. Per modificare un criterio per utente, utilizzare una sintassi simile alla seguente: -Identity "SalesDepartmentPolicy".

Se questo parametro non viene incluso, Set-CsClientVersionPolicy modificherà il criterio globale.

Instance

Facoltativo

Oggetto ClientVersionPolicy

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

Description

Facoltativo

Stringa

Consente di fornire informazioni esplicative su un criterio. È possibile ad esempio fornire informazioni che descrivano gli utenti a cui deve essere assegnato il criterio.

Rules

Facoltativo

Modificatore elenco PS

Raccolta di singole regole dei criteri client assegnate al criterio.

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

Parametro opzionale

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

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy. Remove-CsClientVersionPolicy accetta le istanze da pipeline dell'oggetto criterio di versione client.

Tipi restituiti

Set-CsClientVersionPolicy non restituisce un oggetto o un valore. Il cmdlet configura invece istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy.

Esempio

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

Set-CsClientVersionPolicy -Identity site:Redmond -Rules $Null

$x = Get-CsClientVersionPolicy -Identity site:Dublin | Select-Object -ExpandProperty Rules

Set-CsClientVersionPolicy -Identity site:Redmond -Rules $x

I comandi mostrati nell'esempio 1 copiano tutte le regole versione client da un criterio di versione client a un altro. A tale scopo, nel primo comando dell'esempio viene utilizzato Set-CsClientVersionPolicy per rimuovere tutte le regole dal criterio site:Redmond. A tale scopo, il valore della proprietà Rules viene impostato su Null. Dopo l'eliminazione delle regole, nel secondo comando dell'esempio viene utilizzato Get-CsClientVersionPolicy per recuperare tutte le regole dei criteri di versione client configurate per il criterio site:Dublin. Queste regole sono memorizzate in una variabile denominata $x.

Nell'ultimo comando viene richiamato di nuovo Set-CsClientVersionPolicy, questa volta con la proprietà Rules del criterio Redmond impostata su $x. In questo modo tutte le regole vengono copiate dal criterio site:Dublin e aggiunte al criterio site:Redmond.