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.
Vedere anche
Ulteriori risorse
Remove-CsImFilterConfiguration
Set-CsImFilterConfiguration
Get-CsImFilterConfiguration