Condividi tramite

  • Articolo

New-CsImFilterConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Crea una nuova configurazione del filtro di messaggistica istantanea. I filtri di messaggistica istantanea sono utilizzati per impedire agli utenti di inviare messaggi istantanei contenenti collegamenti ipertestuali attivi.

Sintassi

New-CsImFilterConfiguration -Identity <XdsIdentity> [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-InMemory <SwitchParameter>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-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 New-CsImFilterConfiguration consente di definire un elenco di prefissi URI da filtrare (nonché di abilitare e disabilitare del tutto il filtro) all'interno di un sito specifico. Una chiamata a New-CsImFilterConfiguration in cui è specificata solamente un'identità consente di creare una nuova configurazione con tale identità e di popolare l'elenco Prefissi per quel sito con un set di prefissi predefiniti che saranno filtrati.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet New-CsImFilterConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Un identificatore univoco che specifica l'ambito della configurazione del filtro di messaggistica istantanea. Le impostazioni globali esistono per impostazione predefinita, quindi non è possibile ricrearle con il cmdlet New-CsImFilterConfiguration; tuttavia, è possibile creare impostazioni a livello di sito specificando un'identità site:<nome sito>, dove <nome sito> è il nome del sito a cui saranno applicate le impostazioni (ad esempio site:Redmond).

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

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 si specifica un messaggio nella proprietà AllowMessage, tale messaggio verrà inserito 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.

Valore predefinito: Allow, a meno che un messaggio contenga più di 1.000 URL, caso in cui l'impostazione predefinita è Block.

Tipo di dati completi: Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.UrlFilterAction

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, un collegamento ipertestuale contenente un percorso file con un'estensione specificata dalla proprietà Extensions definita nella configurazione del filtro di trasferimento file applicabile (recuperata tramite il cmdlet Get-CsFileTransferFilterConfiguration) è bloccato e viene restituito un messaggio di errore al mittente. Se il parametro è impostato su False, non viene eseguito alcun particolare controllo 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.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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

Nessuno.

Tipi restituiti

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

Esempio

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

New-CsImFilterConfiguration -Identity site:Redmond

Nel comando mostrato, New-CsImFilterConfiguration è utilizzato per creare una nuova configurazione del filtro di messaggistica istantanea con identità site:Redmond. Dal momento che non sono specificati parametri aggiuntivi, queste impostazioni saranno create utilizzando i valori predefiniti.

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

New-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{add="rtsp:","urn:"}

In questo comando, New-CsImFilterConfiguration è utilizzato per creare una nuova configurazione del filtro di messaggistica istantanea con identità site:Redmond. Poiché è stato specificato il parametro Prefixes, la nuova configurazione conterrà tutti i valori predefiniti, compresi i prefissi predefiniti da filtrare, più due prefissi URI aggiuntivi: rtsp: e urn:. Questi prefissi vengono aggiunti utilizzando il modificatore per l'aggiunta di prefissi all'elenco predefinito.

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

New-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{replace="rtsp:","urn:"}

In questo comando, New-CsFileTransferFilterConfiguration è utilizzato per creare una nuova configurazione del filtro di messaggistica istantanea con identità site:Redmond. Questo esempio è simile all'esempio 2, tranne per il fatto che è stato utilizzato il modificatore per la sostituzione dell'elenco, anziché quello per l'aggiunta all'elenco. In pratica, tutti i prefissi URI predefiniti saranno sostituiti da questi due prefissi (rtsp: e urn:). Di conseguenza, saranno filtrati solo gli URI con i prefissi rtsp: o urn: nei messaggi istantanei per il sito Redmond.