Condividi tramite

  • Articolo

Remove-CsImFilterConfiguration

 

Ultima modifica dell'argomento: 2012-03-27

Consente di rimuovere la configurazione del filtro di messaggistica istantanea specificata. Le impostazioni del filtro IM vengono utilizzate per impedire agli utenti di inviare messaggi istantanei contenenti collegamenti ipertestuali.

Sintassi

Remove-CsImFilterConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Quando si inviano messaggi istantanei, gli utenti possono incorporare nel testo del messaggio un URI (Uniform Resource Identifier) per rimandare a una condivisione o a un sito Web specifico gli altri partecipanti alla conversazione. È possibile configurare Microsoft Lync Server 2010 in modo che i collegamenti ipertestuali con determinati prefissi vengano bloccati o non risultino attivi. In altri termini, i partecipanti non possono semplicemente fare clic sul collegamento per accedere al sito a cui fa riferimento l'URI, ma devono copiare e incollare manualmente il collegamento in un browser.

Il cmdlet Remove-CsImFilterConfiguration consente di rimuovere le impostazioni del filtro IM per una determinata identità, ad esempio, un sito specifico. L'utilizzo di questo cmdlet per l'identità Global consente di ripristinare le impostazioni predefinite nella configurazione globale.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Remove-CsImFilterConfiguration 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-CsImFilterConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

L'identità univoca della configurazione da rimuovere. Per questo cmdlet Identity sarà Global o Site:<nome sito>, in cui <nome sito> indica il nome del sito a cui sono applicate le impostazioni.

Tipo di dati completi: Microsoft.Rtc.Management.Xds.XdsIdentity

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate le modifiche.

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.Settings.ImFilter.ImFilterConfiguration. Accetta l'input tramite pipeline degli oggetti configurazione filtro IM.

Tipi restituiti

Consente di rimuovere un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

Esempio

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

Remove-CsImFilterConfiguration -Identity site:Redmond

Nell'Esempio 1, viene utilizzato il cmdlet Remove-CsImFilterConfiguration per rimuovere la configurazione del filtro IM con Identity site:Redmond. Quando da un sito viene rimossa una configurazione del filtro IM, per quel sito verranno automaticamente utilizzate le impostazioni globali.

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

Get-CsImFilterConfiguration -Filter site:* | Remove-CsImFilterConfiguration

Nell'Esempio 2 vengono rimosse tutte le configurazioni del filtro IM nell'ambito del sito. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsImFilterConfiguration e il parametro Filter per ottenere tutte le configurazioni nell'ambito del sito; il valore con caratteri jolly site:* indica al cmdlet Get-CsImFilterConfiguration che deve restituire solo quelle impostazioni la cui identità inizia con site:. La raccolta di configurazioni filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsImFilterConfiguration che elimina ogni configurazione nella raccolta.