Condividi tramite

  • Articolo

Set-CsClientVersionPolicyRule

 

Ultima modifica dell'argomento: 2012-03-26

Consente di modificare una o più regole dei criteri della versione client configurate per l'utilizzo nella propria organizzazione.

Sintassi

Set-CsClientVersionPolicyRule [-Identity <XdsIdentity>] [-Action <Allow | AllowAndUpgrade | AllowWithUrl | Block | BlockAndUpgrade | BlockWithUrl>] [-ActionUrl <String>] [-BuildNumber <Nullable>] [-CompareOp <EQL | NEQ | GTR | GEQ | LSS | LEQ>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

Set-CsClientVersionPolicyRule [-Action <Allow | AllowAndUpgrade | AllowWithUrl | Block | BlockAndUpgrade | BlockWithUrl>] [-ActionUrl <String>] [-BuildNumber <Nullable>] [-CompareOp <EQL | NEQ | GTR | GEQ | LSS | LEQ>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Le regole della versione client vengono utilizzate per stabilire quali applicazioni client sono autorizzate ad accedere a Microsoft Lync Server 2010. Quando un utente tenta di accedere a Lync Server 2010, la sua applicazione client invia un'intestazione SIP al server; questa intestazione contiene informazioni dettagliate sull'applicazione, inclusi versione principale, versione secondaria e numero di build. Le informazioni sulla versione vengono verificate in base a una raccolta di regole della versione client per valutare se qualcuna delle regole sia applicabile a quella particolare applicazione. Ad esempio, si supponga che un utente tenti di accedere utilizzando Microsoft Office Communicator 2007 R2. Prima che l'accesso a Lync Server 2010 possa avere luogo, il sistema verifica l'eventuale presenza di una regola della versione client applicabile a Office Communicator 2007 R2. Se tale regola esiste, Lync Server 2010 eseguirà l'azione specificata dalla regola. L'azione deve essere una delle seguenti:

Allow. All'utente viene consentito l'accesso.

AllowAndUpgrade. All'utente viene consentito l'accesso e la sua copia di Communicator 2007 R2 viene automaticamente aggiornata all'ultima versione di Lync. Gli aggiornamenti vengono eseguiti utilizzando i servizi Microsoft Update o Windows Server Update, a seconda di come è stato configurato il sistema.

AllowWithUrl. All'utente viene consentito l'accesso e viene visualizzato un messaggio che rimanda l'utente a un URL dal quale scaricare e installare l'ultima versione di Lync. L'URL deve puntare ad un sito creato appositamente dall'utente; non viene creato nessun sito di quel tipo durante l'installazione di Lync Server.

Block. All'utente non viene consentito l'accesso.

BlockAndUpgrade. All'utente viene consentito l'accesso ma la sua copia di Communicator 2007 R2 viene automaticamente aggiornata all'ultima versione di Lync. L'utente potrà poi tentare l'accesso utilizzando la nuova applicazione client. Gli aggiornamenti vengono eseguiti utilizzando i servizi Microsoft Update o Windows Server Update, a seconda di come è stato configurato il sistema.

BlockWithUrl. All'utente non viene consentito l'accesso, ma viene visualizzato un messaggio che rimanda l'utente a un URL dal quale scaricare e installare l'ultima versione di Lync. L'URL deve puntare ad un sito creato appositamente dall'utente; non viene creato nessun sito di quel tipo durante l'installazione di Lync Server.

Le regole della versione client sono raccolte nei criteri della versione client; questi criteri possono essere configurati nell'ambito globale, nell'ambito del sito, nell'ambito del servizio (servizio di registrazione) o nell'ambito del singolo utente. Il cmdlet Set-CsClientVersionPolicyRule offre la possibilità di modificare le proprietà di una regola per la versione client.

È importante notare che criteri della versione client non si applicano agli utenti federati; gli utenti federati, invece, sono legati ai criteri della versione client utilizzati nella propria organizzazione. Ad esempio, se un utente federato utilizza il client A, un client consentito dall'organizzazione federata. Fino a quando l'organizzazione federata consente l'utilizzo del client A, quell'utente sarà in grado di comunicare con la vostra organizzazione utilizzando quel client. Questo sarà possibile anche se il proprio criterio di versione client blocca l'utilizzo del client A. Il criterio di versione client attuato nella propria organizzazione non sovrascrive i criteri di versione client utilizzati in una organizzazione federata.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsClientVersionPolicyRule 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-CsClientVersionPolicyRule"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco della regola per i criteri della versione client da modificare. L'identità di una regola della versione client è costituita dall'ambito in cui la regola è stata configurata più un identificatore univoco globale (GUID). Ciò significa che una regola avrà un'identità simile alla seguente: site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83.

Instance

Facoltativo

Oggetto regola

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

Action

Facoltativo

Modificatore dell'elenco PS

Azione da eseguire ogni volta che la regola viene attivata (vale a dire, ogni volta che qualcuno tenta di connettersi con il software specificato). I valori validi sono:

Allow. All'utente viene consentito l'accesso.

AllowWithUrl. All'utente viene consentito l'accesso e viene visualizzato un messaggio che rimanda l'utente a un URL dal quale scaricare e installare l'ultima versione di Lync.

AllowAndUpgrade. All'utente viene consentito l'accesso e la sua copia di Communicator viene automaticamente aggiornata all'ultima versione di Lync.

Block. All'utente non viene consentito l'accesso.

BlockWithUrl. All'utente non viene consentito l'accesso, ma viene visualizzato un messaggio che rimanda l'utente a un URL dal quale scaricare e installare l'ultima versione di Lync.

BlockAndUpgrade. All'utente viene consentito l'accesso ma la sua copia di Communicator viene automaticamente aggiornata all'ultima versione di Lync. L'utente potrà poi tentare l'accesso utilizzando la nuova applicazione client.

ActionUrl

Facoltativo

Stringa

URL da cui gli utenti possono scaricare la versione più recente di Lync. Questa proprietà è obbligatoria se l'azione (Action) è impostata su BlockWithUrl o AllowWithUrl

BuildNumber

Facoltativo

Numero intero

Numero build del software. Ad esempio, se la copia di Communicator è versione 2.0.6362.111, BuildNumber è 6362. I numeri build corrispondono alle versioni interne del software durante il processo di sviluppo e consentono di verificare che si stia utilizzando la versione finale invece della versione provvisoria.

CompareOp

Facoltativo

Modificatore dell'elenco PS

Operatore di confronto utilizzato per stabilire se il software client con cui si tenta di connettersi è della versione precedente, successiva o contemporanea di quella specificata nella regola. I valori validi sono:

EQL (uguale a)

NEQ (non uguale a)

GTR (maggiore di)

GEQ (maggiore di o uguale a)

LSS (minore di)

LEQ (minore di o uguale a)

Description

Facoltativo

Stringa

Consente agli amministratori di fornire informazioni aggiuntive sulla regola della versione client. Ad esempio, la descrizione può indicare la persona da contattare in caso si ritenga che la regola debba essere cambiata.

Enabled

Facoltativo

Booleano

Indica se deve essere utilizzata la regola della versione client. Se la proprietà Enabled è impostata su False, la regola verrà ignorata ogni volta che un utente tenterà di connettersi con il software specificato. Il valore predefinito è True.

MajorVersion

Facoltativo

Numero intero

Versione principale del software. Ad esempio, se la copia di Communicator è versione 2.0.6362.111, MajorVersion è 2. Le versioni principali corrispondono al rilascio primario del software.

MinorVersion

Facoltativo

Numero intero

Versione secondaria del software. Ad esempio, se la copia di Communicator è versione 2.0.6362.111, MinorVersion è 0. Le versioni secondarie corrispondono al rilascio provvisorio del software.

Priority

Facoltativo

Numero intero

Priorità relativa della regola. Le regole sono elaborate secondo l'ordine di priorità; la regola con priorità 0 è elaborata per prima, la regola con priorità 1 è elaborata per seconda e così via. Se si assegna una priorità già utilizzata, alla nuova regola verrà applicata quella priorità e le altre regole verranno rinumerate di conseguenza.

QfeNumber

Facoltativo

Numero intero

Numero QFE (Quick Fix Engineering) del software. Se, ad esempio, la versione della copia di Communicator è 2.0.6362.111, il parametro QfeNumber sarà 111. I numeri QFE rappresentano gli aggiornamenti pianificati a un'applicazione resi disponibili dopo la versione ufficiale del software.

UserAgent

Facoltativo

Stringa

Indicatore utilizzato per identificare il client software. Ad esempio, OC è l'indicatore dell'agente utente per Communicator. Il cmdlet Get-CsClientVersionConfiguration fornisce nome descrittivi corrispondenti per ogni indicazione di agente utente.

UserAgentFullName

Facoltativo

Stringa

Consente agli amministratori di fornire un nome descrittivo per l'agente utente. Anziché, ad esempio, fare affidamento sulla piattaforma UCCP (Unified Communications Client Platform) dell'agente utente per identificare l'agente, gli amministratori possono specificare il nome per intero: Microsoft Unified Communications Client.

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.Rule. Set-CsClientVersionPolicyRule accetta istanze dell'oggetto regola versione client inviate tramite pipeline.

Tipi restituiti

Nessuno. Invece, Set-CsClientVersionPolicyRule modifica le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule.

Esempio

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

Set-CsClientVersionPolicyRule -Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820 -Enabled $False

Il comando riportato nell'Esempio 1 consente di disabilitare la regola per i criteri della versione client con Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820. Per disabilitare la regola, il comando include il parametro Enabled e il valore del parametro $False.

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

Get-CsClientVersionPolicyRule -Filter "site:Redmond*" | Set-CsClientVersionPolicyRule -Description "Client policy rules for Redmond"

Nell'Esempio 2, viene aggiunta una descrizione generica a tutte le regole della versione client assegnate al sito Redmond. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsClientVersionPolicyRule insieme al parametro Filter; il valore del filtro "site:Redmond*" restituisce solo i dati relativi alle regole assegnate al sito Redmond. Questa raccolta viene quindi inviata tramite pipe al cmdlet Set-CsClientVersionPolicyRule che assegna la descrizione "Client policy rules for Redmond" a ogni singolo elemento della raccolta.

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

Get-CsClientVersionPolicyRule | Where-Object {$_.UserAgent -eq "UCCP"} | Set-CsClientVersionPolicyRule -Action "Block"

Il comando precedente blocca l'utilizzo dei client UCCP (Unified Communications Client Platform) per una regola della versione client che fa riferimento a UCCP come agente utente. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsClientVersionPolicyRule per ottenere una raccolta di tutte le regole utilizzate al momento. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quelle regole in cui la proprietà UserAgent è uguale a (-eq) UCCP. Questa raccolta filtrata viene inviata tramite pipe al cmdlet Set-CsClientVersionPolicyRule che imposta il valore Block per la proprietà Action di ogni singolo elemento della raccolta.