Condividi tramite

  • Articolo

New-CsClientVersionPolicyRule

 

Ultima modifica dell'argomento: 2012-03-23

Crea una nuova regola di criteri versione client. Le regole di criteri di versione client consentono di determinare se gli utenti possono utilizzare un'applicazione client specifica per accedere a Microsoft Lync Server 2010.

Sintassi

New-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>] [-InMemory <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

New-CsClientVersionPolicyRule -Parent <String> -RuleId <String> [-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>] [-InMemory <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Le regole di criteri di versione client vengono utilizzate per determinare a quali applicazioni client è consentito effettuare 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. Le informazioni sulla versione vengono quindi confrontate con un insieme di regole versione client per verificare se esiste una regola da applicare all'applicazione specifica. Si supponga ad esempio che un utente tenti di effettuare l'accesso utilizzando Microsoft Office Communicator 2007 R2. Prima di concedere all'utente l'accesso a Lync Server 2010, il sistema controlla se esiste una regola di versione client valida per Office Communicator 2007 R2. In caso affermativo, Lync Server 2010 eseguirà l'azione specificata dalla regola. L'azione deve essere una tra quelle riportate di seguito:

Allow. All'utente sarà consentito effettuare l'accesso.

AllowAndUpgrade. All'utente sarà consentito effettuare l'accesso e la relativa copia di Communicator 2007 R2 verrà aggiornata automaticamente all'ultima versione di Lync. Gli aggiornamenti verranno eseguiti utilizzando Microsoft Update o Windows Server Update Services, a seconda di come è stato configurato il sistema.

AllowWithUrl. All'utente sarà consentito effettuare l'accesso e verrà visualizzato un messaggio che lo indirizzerà a un URL da cui sarà possibile scaricare e installare l'ultima versione di Lync. L'URL deve puntare a un sito Web creato personalmente. Questo sito non viene creato automaticamente con l'installazione di Lync Server.

Block. All'utente non sarà consentito effettuare l'accesso.

BlockAndUpgrade. All'utente non sarà consentito effettuare l'accesso, ma la relativa copia di Communicator 2007 R2 verrà aggiornata automaticamente all'ultima versione di Lync. L'utente potrà quindi tentare di effettuare l'accesso utilizzando la nuova applicazione client. Gli aggiornamenti verranno eseguiti utilizzando Microsoft Update o Windows Server Update Services, a seconda di come è stato configurato il sistema.

BlockWithUrl. All'utente non sarà consentito effettuare l'accesso, ma verrà visualizzato un messaggio che lo indirizzerà a un URL da cui sarà possibile scaricare e installare l'ultima versione di Lync. L'URL deve puntare a un sito Web creato personalmente. Questo sito non viene creato automaticamente con l'installazione di Lync Server.

Le regole di criteri di versione client vengono raccolte in criteri di versione client, che possono essere configurati nell'ambito globale, del sito, del servizio (servizio di registrazione) o per utente. Le nuove regole di versione client vengono create con il cmdlet New-CsClientVersionPolicyRule. Quando si crea un nuova regola, è inoltre necessario specificare il parametro Identity di tale regola. Questo parametro è costituito da un ambito, ad esempio site:Redmond, e da un identificatore univoco globale (GUID). È possibile specificare direttamente un valore per il parametro Identity oppure crearlo mediante New-CsClientVerisonPolicyRule specificando l'ambito (parametro Parent) e il GUID (parametro RuleId).

È 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 New-CsClientVersionPolicyRule 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 "New-CsClientVersionPolicyRule"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identificatore univoco per la regola di criteri versione client creata. L'identità di una regola di criteri di versione client è costituita dall'ambito in cui la regola è stata configurata e da un identificatore univoco globale (GUID). La regola avrà un'identità simile a quella riportata di seguito: site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83.

Anziché utilizzare il parametro Identity, è possibile utilizzare i parametri Parent e RuleId in modo da creare l'identità tramite New-CsClientVerisonPolicyRule.

MajorVersion

Obbligatorio

Numero intero

Versione principale del software. Se ad esempio la versione della copia di Communicator è 2.0.6362.111, il parametro MajorVersion sarà 2. Le versioni principali corrispondono alle versioni principali del software. È necessario assegnare un valore alla proprietà MajorVersion ogni volta che si crea una nuova regola.

MinorVersion

Facoltativo

Numero intero

Versione secondaria del software. Se ad esempio la versione della copia di Communicator è 2.0.6362.111, il parametro MinorVersion sarà 0. Le versioni secondarie corrispondono alle versioni intermedie del software.

UserAgent

Obbligatorio

Stringa

Indicatore utilizzato per identificare il client software. OC ad esempio è la designazione di agente utente per Communicator.

Action

Facoltativo

Modificatore elenco PS

Azione da intraprendere ogni volta che viene attivata la regola, ovvero ogni volta che qualcuno tenta di effettuare l'accesso utilizzando il software specificato. I valori validi sono:

Allow. All'utente sarà consentito effettuare l'accesso.

AllowWithUrl. All'utente sarà consentito effettuare l'accesso e verrà visualizzato un messaggio che lo indirizzerà a un URL da cui sarà possibile scaricare e installare l'ultima versione di Lync.

AllowAndUpgrade. All'utente sarà consentito effettuare l'accesso e la relativa copia di Communicator verrà aggiornata automaticamente all'ultima versione di Lync.

Block. All'utente non sarà consentito effettuare l'accesso.

BlockWithUrl. All'utente non sarà consentito effettuare l'accesso, ma verrà visualizzato un messaggio che lo indirizzerà a un URL da cui sarà possibile scaricare e installare l'ultima versione di Lync.

BlockAndUpgrade. All'utente non sarà consentito effettuare l'accesso, ma la relativa copia di Communicator verrà aggiornata automaticamente all'ultima versione di Lync. L'utente potrà quindi tentare di effettuare 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 il parametro Action è impostato su BlockWithUrl o AllowWithUrl.

BuildNumber

Facoltativo

Numero intero

Numero build del software. Se ad esempio la versione della copia di Communicator è 2.0.6362.111, il parametro BuildNumber sarà 6362. I numeri di build rappresentano le versioni interne del software durante il processo di sviluppo e garantiscono che venga utilizzata la versione finale anziché una versione non definitiva.

CompareOp

Facoltativo

Modificatore elenco PS

Operatore di confronto utilizzato per determinare se il software client che sta tentando di effettuare l'accesso è stato rilasciato prima, dopo o contemporaneamente alla versione specificata nella regola. I valori validi sono:

EQL (uguale a)

NEQ (non uguale a)

GTR (maggiore di)

GEQ (maggiore o uguale a)

LSS (minore di)

LEQ (minore o uguale a)

Description

Facoltativo

Stringa

Consente agli amministratori di fornire informazioni aggiuntive sulla regola versione client. Ad esempio, il parametro Description potrebbe includere le informazioni sulla persona da contattare nel caso in cui si ritenga che la regola debba essere modificata.

Enabled

Facoltativo

Booleano

Indica se utilizzare la regola versione client. Se la proprietà Enabled è impostata su False ($False), la regola verrà ignorata ogni volta che l'utente tenta di effettuare l'accesso con il software specificato. Il valore predefinito è True.

Parent

Facoltativo

Stringa

Informazioni sull'ambito per la nuova regola. Per utilizzare il parametro Parent e creare una nuova regola per il criterio globale, utilizzare la seguente sintassi: -Parent global. Per creare una nuova regola per un criterio di sito, utilizzare una sintassi simile alla seguente: -Parent "site:Redmond". Per creare una nuova regola per un criterio di servizio, utilizzare una sintassi simile alla seguente: -parent "Registrar:atl-cs-001.litwareinc.com". Per creare una nuova regola per un criterio per utente, utilizzare una sintassi simile alla seguente: -Parent "RedmondClientVersionPolicy".

Quando si crea una nuova regola, è necessario utilizzare il parametro Identity oppure entrambi i parametri Parent e RuleId.

Priority

Facoltativo

Numero intero

Priorità relativa della regola. Le regole vengono elaborate in ordine di priorità, con 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à in uso, la nuova regola utilizzerà tale 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 per un'applicazione resi disponibili dopo la distribuzione della versione ufficiale del software.

RuleId

Facoltativo

Guid

Identificatore univoco globale (GUID) della regola. In Windows PowerShell è possibile creare un GUID utilizzando il seguente comando:

$x = [guid]::NewGuid()

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 non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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

Nessuno. New-CsClientVersionPolicyRule non accetta l'input da pipeline.

Tipi restituiti

New-CsClientVersionPolicyRule crea nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule.

Esempio

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

$x = [guid]::NewGuid()

New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -MajorVersion 4 -UserAgent InHouse

Nell'esempio 1 viene illustrato come creare una nuova regola di criteri versione client. Il parametro Identity delle regole di criteri è costituito da due parti: l'ambito in cui deve essere assegnato l'annuncio e un GUID di 36 caratteri. Per creare un parametro Identity per una nuova regola di criteri versione client, è necessario innanzitutto utilizzare il metodo NewGuid di .NET Framework al fine di creare un nuovo GUID. Questo passaggio viene eseguito nel primo comando dell'esempio, in cui il GUID risultante viene archiviato nella variabile $x.

Dopo la creazione del GUID, è possibile utilizzare New-CsClientVersionPolicyRule per creare la nuova regola. Questo comando utilizza quattro parametri: Parent, il cui valore rappresenta l'ambito (site:Redmond) della nuova regola, RuleId, il cui valore $x rappresenta il GUID appena creato, MajorVersion (4) e UserAgent (InHouse). In questo caso, il parametro UserAgent rappresenta un'applicazione client interna.

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

$x = [guid]::NewGuid()

$z = New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -InMemory
$z.MajorVersion = 4 
$z.UserAgent = "Inhouse"
Set-CsClientVersionPolicyRule -Instance $z

I comandi mostrati nell'esempio 2 rappresentano una variazione dei comandi mostrati nel primo esempio. In questo caso tuttavia la nuova regola viene creata inizialmente solo in memoria e aggiunta successivamente a Lync Server 2010. A tale scopo, il primo comando dell'esempio crea la parte GUID del parametro Identity. Con il secondo comando viene creata una nuova regola di criteri di versione client solo in memoria. Il parametro InMemory garantisce che la regola sia presente solo in memoria e che non venga aggiunta immediatamente all'infrastruttura di Lync Server 2010. Come nell'esempio 1, i parametri Parent e RuleId vengono utilizzati per specificare l'ambito e il GUID della nuova regola, ovvero le due parti che costituiscono il parametro Identity della regola.

Dopo la creazione della regola virtuale, i due comandi successivi vengono utilizzati per assegnare rispettivamente i valori alle proprietà MajorVersion e UserAgent. Dopo aver completato queste attività, nell'ultimo comando dell'esempio viene utilizzato il cmdlet Set-CsClientVersionPolicyRule per creare la regola di criteri di versione client vera e propria e assegnarla al sito Redmond.