Condividi tramite

  • Articolo

Set-CsImFilterConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Modifica una configurazione esistente del filtro di messaggistica istantanea. Le impostazioni del filtro di messaggistica istantanea sono utilizzate per impedire agli utenti di inviare messaggi istantanei contenenti collegamenti ipertestuali attivi (selezionabili).

Sintassi

Set-CsImFilterConfiguration [-Identity <XdsIdentity>] [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-WhatIf [<SwitchParameter>]]

Set-CsImFilterConfiguration [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-Instance <PSObject>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Quando vengono inviati 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 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 Set-CsImFilterConfiguration consente di modificare un elenco di prefissi URI da filtrare, nonché di abilitare e disabilitare completamente il filtro a livello globale o all'interno di un sito specifico. Con questo cmdlet è anche possibile aggiornare i diversi messaggi di avviso visualizzati agli utenti.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsImFilterConfiguration i membri dei seguenti gruppi: 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 "Set-CsImFilterConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

L'identificatore univoco delle impostazioni di configurazione del filtro dei messaggi istantanei che si desidera modificare. Questo valore sarà global o site:<nome sito>, dove <nome sito> è il sito a cui si applica la configurazione, ad esempio site:Redmond.

Instance

Facoltativo

ImFilterConfiguration

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. Il cmdlet accetta un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration, che può essere recuperato chiamando il cmdlet Get-CsImFilterConfiguration.

Action

Facoltativo

UrlFilterAction

Il valore di questo parametro determina l'azione da eseguire quando in un messaggio istantaneo è incluso un collegamento ipertestuale:

Allow - I collegamenti ipertestuali contengono un carattere di sottolineatura (_) come prefisso in modo che i collegamenti non siano più attivi. Se inoltre si specifica un messaggio nella proprietà AllowMessage, verrà inserito un messaggio di notifica all'inizio di ogni messaggio istantaneo contenente collegamenti ipertestuali.

Block - La consegna di messaggi contenenti collegamenti ipertestuali attivi è bloccata e Lync Server 2010 invia un messaggio di errore al mittente.

Warn - I messaggi contenenti collegamenti ipertestuali attivi vengono recapitati ai destinatari, unitamente a un messaggio di avviso inserito all'inizio dei messaggi. È possibile specificare il messaggio di avviso utilizzando la proprietà WarnMessage. Se si specifica Warn e non si immette la proprietà WarnMessage, il filtro di protezione dei messaggi istantanei viene disabilitato, anche se le impostazioni relative alla proprietà BlockFileExtension vengono comunque rispettate.

AllowMessage

Facoltativo

Stringa

Se si specifica un valore per il parametro, quando il valore della proprietà Action è impostato su Allow, la stringa viene inserita all'inizio di ogni messaggio contenente collegamenti ipertestuali. È possibile utilizzare questo messaggio per l'invio di notifiche agli utenti, ad esempio sui potenziali pericoli che derivano dalla selezione di collegamenti sconosciuti o sui criteri e i requisiti relativi all'organizzazione.

BlockFileExtension

Facoltativo

Booleano

Se il parametro è impostato su True, viene bloccato un collegamento ipertestuale contenente un percorso file con un'estensione specificata dalla proprietà Extensions definita nella classe Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration (recuperata tramite il cmdlet Get-CsFileTransferFilterConfiguration) e viene restituito un messaggio di errore al mittente. Se il parametro è impostato su False, non viene eseguito alcun particolare controllo sui percorsi e sulle estensioni dei file.

Valore predefinito: True

Enabled

Facoltativo

Booleano

Consente di abilitare o disabilitare questa funzionalità. Se il parametro è impostato su True, i messaggi istantanei verranno esaminati alla ricerca di collegamenti ipertestuali e si applicheranno le regole all'interno della configurazione. Se il parametro è impostato su False, i messaggi non verranno controllati alla ricerca di collegamenti ipertestuali.

Valore predefinito: True

IgnoreLocal

Facoltativo

Booleano

Il valore di questo parametro controlla se il filtraggio viene eseguito sugli URI della Intranet locale passati nei messaggi istantanei. Se il parametro è impostato su True, qualsiasi URI definito all'interno dell'area Intranet del computer locale viene ignorato. Il computer locale è il server Front End che esegue l'applicazione del filtro di messaggistica istantanea. Se il parametro è impostato su False, il filtro di protezione specificato viene applicato a tutti i collegamenti ipertestuali.

Valore predefinito: True

Prefixes

Facoltativo

PSListModifier

L'elenco dei prefissi URI che verranno filtrati. Qualsiasi collegamento ipertestuale incluso in un messaggio istantaneo con un prefisso corrispondente a uno dei prefissi in elenco verrà filtrato in base alle impostazioni specifiche.

Valore predefinito: callto:, file:, ftp., ftp:, gopher:, href, http:, https:, ldap:, mailto:, news:, nntp:, sip:, sips:, tel:, telnet:, www*.

WarnMessage

Facoltativo

Stringa

Quando il valore della proprietà Action è impostato su Warn, questo parametro contiene il messaggio di avviso inserito all'inizio di ogni messaggi istantaneo contenente i collegamenti ipertestuali. Questo tipo di messaggio viene generalmente utilizzato per l'invio di notifiche sui potenziali pericoli derivanti dalla selezione di collegamenti sconosciuti o sui criteri e i requisiti relativi all'organizzazione.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare 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 da pipeline di oggetti di configurazione del filtro di messaggistica istantanea.

Tipi restituiti

Set-CsImFilterConfiguration non restituisce un valore o un oggetto. Il cmdlet configura invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

Esempio

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

Set-CsImFilterConfiguration -Identity site:Redmond -Enabled $False

Il comando riportato in questo esempio disabilita il meccanismo di filtro URI per la configurazione del filtro di messaggistica istantanea con valore Identity site:Redmond. Per eseguire questa attività, viene specificato il parametro Enabled con valore $False nella chiamata al cmdlet Set-CsImFilterConfiguration.

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

$x = Get-CsImFilterConfiguration -Identity site:Redmond
$x.Prefixes.Add("urn:")
Set-CsImFilterConfiguration -Instance $x

Il set di comandi precedente aggiunge un nuovo prefisso URI (urn:) all'elenco dei prefissi vietati dalla configurazione del filtro di messaggistica istantanea per site:Redmond. Per aggiungere il nuovo prefisso, viene utilizzato il cmdlet Get-CsImFilterConfiguration per recuperare la configurazione per site:Redmond. L'oggetto restituito che rappresenta la configurazione viene archiviato in una variabile denominata $x. Dopo il recupero delle impostazioni, viene chiamato il metodo Add() nella riga 2 per aggiungere urn: al set dei prefissi memorizzati nella proprietà Prefixes. Questa operazione cambia il valore del riferimento dell'oggetto $x. Per cambiare la configurazione vera e propria, la riga 3 chiama il cmdlet Set-CsImFilterConfiguration, passando $x come unico valore del parametro.

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

Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{add="urn:"}

L'esempio 3 esegue la stessa operazione descritta nell'esempio 2, ma lo fa in un'unica riga. In questo comando viene utilizzato il parametro Prefixes del cmdlet Set-CsImFilterConfiguration per aggiungere urn: all'elenco dei prefissi. Il modificatore di elenco Add è utilizzato per aggiungere questo valore all'elenco dei prefissi.

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

Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{remove="urn:"}

In questo esempio, il prefisso urn: viene rimosso dall'elenco dei prefissi bloccati dalla configurazione del filtro di messaggistica istantanea per site:Redmond. Questo esempio è identico all'esempio 3: la sola differenza consiste nel fatto che, invece di chiamare il modificatore di elenco Add per aggiungere un prefisso all'elenco, viene chiamato il modificatore di elenco Remove per rimuovere un prefisso.