Condividi tramite

  • Articolo

Remove-CsClientVersionPolicyRule

 

Ultima modifica dell'argomento: 2012-03-25

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

Sintassi

Remove-CsClientVersionPolicyRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 possa avere luogo, il sistema verifica l'eventuale presenza di una regola della versione client applicabile a Office Communicator 2007 R2. Se la 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 che possono essere configurati nell'ambito globale, nell'ambito del sito, nell'ambito del servizio (servizio di registrazione) o nell'ambito per utente. Il cmdlet Remove-CsClientVersionPolicyRule consente di eliminare una o più regole dei criteri client configurate per l'utilizzo nella propria organizzazione. Queste regole possono essere eliminate da uno qualunque dei propri criteri della versione client, incluso il criterio globale.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco della regola per i criteri della versione client da rimuovere. 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.

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

Tipi restituiti

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

Esempio

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

Remove-CsClientVersionPolicyRule -Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820

Il comando riportato nell'Esempio 1 consente di eliminare la regola per i criteri della versione client con Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820. Poiché le identità devono essere univoche, il comando eliminerà al massimo una regola.

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

Get-CsClientVersionPolicyRule -Filter "site:Redmond/*" | Remove-CsClientVersionPolicyRule

Il comando precedente elimina tutte le regole per i criteri della versione client configurate per il 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 a quelle regole la cui identità inizia con la stringa "site:Redmond/". Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsClientVersionPolicyRule che elimina ogni elemento nella raccolta.

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

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

L'Esempio 3 consente di eliminare tutte le regole per i criteri della versione client attualmente disabilitate. Per ottenere questo risultato, il comando utilizza prima Get-CsClientVersionPolicyRule senza alcun parametro aggiuntivo in modo da ottenere una raccolta di tutte le regole attualmente in uso nell'organizzazione. 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. La raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsClientVersionPolicyRule che elimina ogni elemento nella raccolta.