Condividi tramite

  • Articolo

Get-CsImFilterConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce i filtri per i collegamenti presenti nei messaggi istantanei configurati nell'organizzazione. Questi filtri vengono utilizzati per impedire agli utenti di inviare messaggi istantanei che contengono collegamenti ipertestuali con determinati prefissi, ad esempio collegamenti con un prefisso http o telnet. A seconda delle impostazioni, ciò significa che qualsiasi URI (Uniform Resource Identifier) preceduto da uno di questi schemi verrà convertito in un collegamento ipertestuale non selezionabile oppure verrà rimosso del tutto.

Sintassi

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

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

Descrizione dettagliata

Quando vengono inviati messaggi istantanei, gli utenti possono incorporare nel testo del messaggio un URI per rimandare a una condivisione o a un sito Web particolare 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 manualmente copiare e incollare il collegamento in un browser.

Il cmdlet Get-CsImFilterConfiguration recupera tutte le impostazioni per filtrare gli URI nei messaggi istantanei. Chiamato da solo (senza alcun parametro), Get-CsImFilterConfiguration restituisce tutte le impostazioni di filtro per gli URI presenti nei messaggi istantanei, a livello globale e per tutti i siti. È anche possibile specificare un'identità per visualizzare le impostazioni per un determinato sito (o le impostazioni globali).

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsImFilterConfiguration i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

l'identificatore univoco delle impostazioni che si desidera recuperare. Sarà global o site:<nome sito>, dove <nome sito> è il nome del sito al quale si applicano queste impostazioni, ad esempio, site:Redmond.

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

Filter

Facoltativo

Stringa

Esegue una ricerca con caratteri jolly per individuare le configurazioni che corrispondono a un determinata sequenza di caratteri relativa all'identità. Ad esempio, restituisce tutte le impostazioni la cui identità inizia con site* (tutte impostazioni specifiche del sito).

LocalStore

Facoltativo

Parametro opzionale

Recupera la configurazione dei filtri per i messaggi istantanei dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno.

Tipi restituiti

Get-CsImFilterConfiguration restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

Esempio

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

Get-CsImFilterConfiguration

Il comando sopra riportato restituisce una raccolta di tutti i filtri per i collegamenti ipertestuali dei messaggi istantanei configurati per l'utilizzo nell'organizzazione. Questo è il comportamento predefinito ogni volta che si chiama Get-CsImFilterConfiguration senza ulteriori parametri.

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

Get-CsImFilterConfiguration -Identity site:Redmond

Nell'esempio precedente vengono restituite le impostazioni relative a un singolo filtro per messaggi istantanei, ovvero le impostazioni con identità site:Redmond. Poiché le identità devono essere univoche, in comando non restituirà mai più di una configurazione.

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

Get-CsImFilterConfiguration -Filter site:*

Nell'esempio 3 viene utilizzato il parametro Filter per restituire una raccolta di tutti i filtri per messaggi istantanei che sono stati configurati a livello del sito. La stringa con caratteri jolly site:* indica a Get-CsImFilterConfiguration di restituire solo le configurazioni dei filtri per messaggi istantanei il cui parametro Identity inizia con il valore stringa site:.

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

(Get-CsImFilterConfiguration -Identity Global).Prefixes

Nell'esempio 4 il valore della proprietà Prefixes della configurazione globale dei filtri per messaggi istantanei è "espanso" quando viene visualizzato. Questo significa semplicemente che la proprietà e i relativi valori vengono visualizzati in un formato più semplice e leggibile. Per eseguire questa attività, viene innanzitutto utilizzato Get-CsImFilterConfiguration per recuperare la configurazione globale dei filtri per messaggi istantanei. La chiamata a Get-CsImFilterConfiguration è racchiusa tra parentesi. Ciò significa che Windows PowerShell deve innanzitutto eseguire il comando racchiuso tra parentesi, quindi deve procedere da quel punto. Una volta recuperata la configurazione, viene visualizzato il valore della proprietà Prefixes con un prefisso su ciascuna riga.