Condividi tramite

  • Articolo

New-CsClientVersionPolicy

 

Ultima modifica dell'argomento: 2012-03-23

Consente di creare nuovi criteri di versione client. I criteri di versione client consentono di specificare quali versioni di client (ad esempio Microsoft Office Communicator 2007 R2) saranno in grado di accedere al sistema Microsoft Lync Server 2010.

Sintassi

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

Descrizione dettagliata

I criteri della versione client rappresentano una raccolta di regole per la versione client; a loro volta, le regole per la versione client vengono utilizzate per stabilire quali applicazioni client sono autorizzate ad accedere a 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 incluse nell'intestazione SIP vengono poi verificate in base a una raccolta di regole della versione client per valutare se qualcuna delle regole sia applicabile a quella particolare applicazione. Se la regola esiste, Lync Server 2010 eseguirà l'azione specificata dalla regola. Ad esempio, la regola potrebbe indicare a Lync Server 2010 di consentire l'accesso, di bloccarlo o consentire l'accesso poi, automaticamente, aggiornare l'applicazione client all'ultima versione (ad esempio, aggiornare Communicator 2007 R2 a Microsoft Lync 2010).

I criteri di versione client che è possibile applicare all'ambito globale, ambito di sito e ambito di servizio (solo al servizio di registrazione) o all'ambito per utente, offrono notevole flessibilità nel determinare quali applicazioni client è possibile utilizzare per accedere al sistema. Ad esempio, come regola generale si potrebbe voler impedire agli utenti di accedere a Lync Server 2010 utilizzando Communicator 2007 R2; potrebbe essere necessario in quanto le vecchie applicazioni non supportano le stesse funzionalità e capacità di Lync 2010. Tuttavia, a causa di conflitti hardware o software potrebbe esistere un gruppo di utenti che non possono aggiornarsi a Lync 2010. In quel caso, si può creare una regola separata e un corrispondente criterio della versione client per consentire a quegli utenti di accedere al sistema utilizzando Communicator 2007 R2.

Si noti, tuttavia, che agli utenti anonimi vengono applicati solo i criteri globali. Ciò avviene in quanto gli utenti anonimi non sono associati a un sito o a un servizio e non è pertanto possibile assegnare loro un criterio per utente.

È possibile creare nuovi criteri della versione client utilizzando il cmdlet New-CsClientVersionPolicy. Questi nuovi criteri possono essere creati in ambito di sito, in ambito di servizio (solo servizio di registrazione) ed in ambito per utente.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identificatore univoco del criterio da creare. Per creare un criterio nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond". Per creare un criterio nell'ambito del servizio, utilizzare una sintassi simile alla seguente: -Identity "Registrar:atl-cs-001.litwareinc.com". Il servizio di registrazione è il solo servizio che può ospitare un criterio di versione client.

I criteri possono essere creati anche nell'ambito per utente. Per creare un criterio per utente, utilizzare una sintassi simile alla seguente: -Identity "SalesDepartmentPolicy".

Description

Facoltativo

Stringa

Consente di fornire del testo esplicativo per il criterio. Ad esempio, potrebbero essere indicati gli utenti ai quali deve essere assegnato il criterio.

Rules

Facoltativo

Modificatore dell'elenco PS

Raccolta di regole per i criteri della versione client. Le regole sono facilmente aggiunte o tolte da un criterio utilizzando i cmdlet New-CsClientVersionPolicyRule e Remove-CsClientVersionPolicyRule. Per aggiungere una nuova regola nel momento in cui si crea il nuovo criterio, creare la regola e memorizzarla in una variabile (ad esempio $x). Si può utilizzare una sintassi simile a questa per creare un nuovo criterio:

New-CsClientVersionPolicy –Identity "RedmondClientVersionPolicy" –Rules @{Add=$x}

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.

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. Get-CsClientVersionPolicy non accetta input tramite pipeline.

Tipi restituiti

New-CsClientVersionPolicy consente di creare nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy.

Esempio

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

New-CsClientVersionPolicy -Identity site:Redmond

Nell'Esempio 1, viene creato un nuovo criterio della versione client per il sito Redmond. Poiché non vengono specificati parametri (oltre all'obbligatorio Identity) il nuovo criterio conterrà tutti i valori predefiniti per un criterio di versione client.

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

Get-CsSite | Select-Object Identity | ForEach-Object {New-CsClientVersionPolicy -Identity ("site:" + $_.Identity)}

Il comando riportato nell'Esempio 2 consente di creare un nuovo criterio della versione client per tutti i siti nell'organizzazione. Per ottenere questo risultato, il comando prima utilizza Get-CsSite senza alcun parametro; viene restituita una raccolta di tutti i siti nella topologia. Questa raccolta viene poi inviata tramite pipe al cmdlet Select-Object che seleziona la proprietà Identity di ciascun sito. Queste identità vengono inviate tramite pipe a ForEach-Object che crea un nuovo criterio della versione client per ciascun sito nella raccolta.