Condividi tramite

  • Articolo

Get-CsClientVersionPolicyRule

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce le regole dei criteri di versione client configurate per essere utilizzate nell'organizzazione.

Sintassi

Get-CsClientVersionPolicyRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsClientVersionPolicyRule [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Le regole di criteri versione client vengono utilizzate per determinare a quali applicazioni client è consentito effettuare l'accesso 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 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 che possa essere effettuato l'accesso a Lync Server 2010, il sistema controllerà se esiste una regola di versione client valida per Office Communicator 2007 R2. Se tale regola esiste, 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 vengono eseguiti tramite Microsoft Update o Windows Server Update Services, in base alla configurazione del 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 precedentemente dall'utente, poiché tale sito non viene creato durante 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 vengono eseguiti tramite Microsoft Update o Windows Server Update Services, in base alla configurazione del sistema.

BlockWithUrl. All'utente non sarà consentito effettuare l'accesso, ma verrà visualizzato un messaggio che lo indirizzerà ad un URL da cui sarà possibile scaricare e installare l'ultima versione di Lync. L'URL deve puntare a un sito Web creato precedentemente dall'utente, poiché tale sito non viene creato durante l'installazione di Lync Server.

Le regole di versione client vengono raccolte nei criteri di versione client che possono essere configurati nell'ambito globale, nell'ambito del sito, nell'ambito del servizio (servizio Registrar) o nell'ambito per utente. Il cmdlet Get-CsClientVersionPolicyRule consente agli amministratori di visualizzare informazioni dettagliate su ciascuna delle regole dei criteri configurate per l'utilizzo nell'organizzazione.

È importante notare che i criteri di versione client non vengono applicati agli utenti federati, poiché essi sono vincolati dai criteri di versione client utilizzati nell'organizzazione di appartenenza. Si supponga ad esempio che un utente federato utilizzi il client A, un client consentito dall'organizzazione federata. Se l'organizzazione federata consente l'utilizzo del client A, l'utente potrà comunicare con l'organizzazione mediante tale client. Ciò si verifica anche se il criterio di versione client blocca l'uso del client A. I criteri di versione client adottati nell'organizzazione non sostituiscono i criteri di versione client utilizzati nell'organizzazione federata.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet Get-CsClientVersionPolicyRule in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

L'identificatore univoco per la regola del criterio di versione client da recuperare. L'identità di una regola 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. Poiché i GUID sono difficili da ricordare e da utilizzare, nella sezione Esempi della Guida vengono elencati metodi alternativi che consentono di identificare le regole da restituire.

Se questo parametro non viene specificato, verranno restituite tutte le regole dei criteri di versione client configurate per l'utilizzo.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly quando si specificano le regole dei criteri di versione client da restituire. Ad esempio, per restituire tutte le regole configurate per il sito di Redmond, utilizzare la seguente sintassi: -Filter "site:Redmond/*".

Non è possibile utilizzare i parametri Filter e Identity nello stesso comando.

LocalStore

Facoltativo

Parametro opzionale

Recupera la regola del criterio di versione client dalla replica locale del archivio di gestione centrale anziché dallo stesso archivio di gestione centrale.

Tipi di input

Nessuno. Get-CsClientVersionPolicyRule non accetta input inviato tramite pipe.

Tipi restituiti

Get-CsClientVersionPolicyRule restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule.

Esempio

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

Get-CsClientVersionPolicyRule

Nell'esempio 1 vengono restituite le informazioni su tutte le regole dei criteri di versione client attualmente in uso nell'organizzazione.

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

Get-CsClientVersionPolicyRule -Identity "Global/2336c611-a243-4c5d-994b-eea8a524d0e4"

Nell'esempio 2 vengono restituite le informazioni su una singola regola del criterio di versione client: la regola con identità Global/2336c611-a243-4c5d-994b-eea8a524d0e4.

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

Get-CsClientVersionPolicyRule -Filter "Global/*"

Il comando precedente restituisce tutte le regole dei criteri di versione client che sono state configurate nell'ambito globale. A tale scopo, il comando utilizza il parametro Filter e il valore del filtro "Global/*". Tale valore del filtro restituisce solamente quelle regole con identità che inizia con il valore stringa "Global/".

-------------------------- Esempio 4 ------------------------

Get-CsClientVersionPolicyRule | Where-Object {$_.Enabled -eq $False}

Il comando indicato nell'esempio 4 restituisce tutte le regole dei criteri di versione client che sono attualmente disabilitate. Per eseguire questa operazione, il comando effettua per prima cosa la chiamata di Get-CsClientVersionPolicy per restituire la raccolta di tutte le regole dei criteri di versione client disponibili. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quelle regole in cui la proprietà Enabled è uguale a False.

-------------------------- Esempio 5 ------------------------

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

Il comando precedente restituisce tutte le regole dei criteri di versione client che bloccano l'accesso a un'applicazione client. A tale scopo, il comando effettua per prima cosa la chiamata di Get-CsClientVersionPolicy senza alcun parametro. In questo modo viene restituita la raccolta delle regole attualmente in uso. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo quelle regole in cui la proprietà Action è uguale a Block.