Condividi tramite


Remove-CsClientVersionPolicy

 

Ultima modifica dell'argomento: 2012-03-26

Consente di rimuovere il criterio della versione client specificato. I criteri di versione client consentono di specificare quali client (ad esempio Microsoft Office Communicator 2007 R2) saranno in grado di accedere al sistema Microsoft Lync Server 2010 in uso.

Sintassi

Remove-CsClientVersionPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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; ciò potrebbe essere necessario in quanto Communicator 2007 R2 non supporta 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.

È possibile creare nuovi criteri utilizzando il cmdlet New-CsClientVersionPolicy. Questi criteri personalizzati possono essere rimossi successivamente utilizzando il cmdlet Remove-CsClientVersionPolicy. Quando si rimuove un criterio della versione client, gli utenti a cui era applicato quel criterio ereditano automaticamente il criterio successivo nella gerarchia di gestione. Ad esempio, se si elimina un criterio per utente, agli utenti verrà automaticamente applicato il criterio del servizio appropriato. Se non esiste alcun criterio del servizio, agli utenti verrà applicato il criterio del sito appropriato. Se non esiste alcun criterio del sito, agli utenti verrà applicato il criterio globale.

Si noti che ci sarà sempre un criterio globale e a tutti gli utenti verrà sempre applicato un criterio della versione client. Sebbene sia possibile utilizzare il cmdlet Remove-CsClientVersionPolicy per il criterio globale, in realtà il criterio non verrà eliminato. Ciò che accade è che per tutte le regole dei criteri verranno ripristinati i valori predefiniti.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco del criterio da eliminare. Per rimuovere un criterio configurato nell'ambito del sito, utilizzare una sintassi analoga alla seguente: -Identity "site:Redmond". Per rimuovere un criterio configurato 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 della versione client.

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

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 dell'oggetto versione client inviate tramite pipeline.

Tipi restituiti

Remove-CsClientVersionPolicy consente di eliminare le istanze esistenti dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy.

Esempio

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

Remove-CsClientVersionPolicy -Identity site:Redmond

Il comando riportato nell'Esempio 1 consente di eliminare il criterio della versione client per il sito Redmond.

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

Get-CsClientVersionPolicy -Filter tag:* | Remove-CsClientVersionPolicy

Nell'Esempio 2, vengono eliminati tutti i criteri della versione client configurati nell'ambito del singolo utente. Per eseguire questa operazione, il comando utilizza prima Get-CsClientVersionPolicy e il parametro Filter; il valore del filtro "tag:*" restituisce solo i dati relativi ai criteri configurati nell'ambito del singolo utente. Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsClientVersionPolicy che elimina ogni elemento della raccolta.