Condividi tramite

  • Articolo

New-CsFileTransferFilterConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Consente di creare una nuova configurazione del filtro di trasferimento file. Le configurazioni del filtro di trasferimento file sono utilizzate per impedire a un utente di trasferire determinati tipi di file (ad esempio, i file con estensione vbs o ps1) utilizzando un client Microsoft Lync Server 2010.

Sintassi

New-CsFileTransferFilterConfiguration -Identity <XdsIdentity> [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Quando si invia un messaggio istantaneo, gli utenti possono allegare e inviare file agli altri partecipanti alla conversazione. È possibile configurare Lync Server 2010 in modo tale che i file con determinate estensioni, in genere le estensioni che caratterizzano tipi di file potenzialmente dannosi, non possano essere inviati tramite un client Lync Server 2010.

Quando si installa Lync Server 2010, viene creata automaticamente (nell'ambito globale) una configurazione del filtro di trasferimento file. Per impostazione predefinita, questa configurazione globale viene applicata a tutti gli utenti dell'organizzazione. Inoltre, è possibile utilizzare il cmdlet New-CsFileTransferFilterConfiguration per creare configurazioni del filtro di trasferimento file personalizzate per singoli siti. Se per un determinato sito è già disponibile una configurazione, le impostazioni di trasferimento file che ne fanno parte verranno applicate a tutti gli utenti del sito. Se per un sito non è disponibile alcuna raccolta di questo tipo, verranno applicate le impostazioni globali.

Si noti che non è possibile creare una nuova configurazione del filtro di trasferimento file nell'ambito globale; tuttavia, è possibile utilizzare il cmdlet Set-CsFileTransferFilterConfiguration per modificare le impostazioni globali. Similmente, non è possibile creare una nuova configurazione per un sito che dispone già di una configurazione; se si tenta di eseguire questa operazione, il comando avrà esito negativo.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsFileTransferFilterConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdministrator. 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 "New-CsFileTransferFilterConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco da assegnare alla configurazione del filtro di trasferimento file. L'identità della nuova configurazione è costituita dal prefisso "site:" seguito dal nome del sito. Ad esempio, per creare una nuova configurazione per il sito Redmond, utilizzare la seguente sintassi: -Identity site:Redmond.

Action

Facoltativo

Stringa

Determina l'azione da intraprendere quando il filtro di trasferimento file è abilitato. Se è impostato su BlockAll, il trasferimento dei file sarà proibito, indipendentemente dall'estensione del file in questione. Se è impostato su Block (valore predefinito), il trasferimento dei file verrà consentito a meno che l'estensione del file in questione non sia presente nell'elenco di estensioni proibite specificate per la proprietà Extensions.

Per consentire il trasferimento di tutte le tipologie di file in modo che gli utenti possano scambiare qualsiasi tipo di file, indipendentemente dall'estensione, impostare la proprietà Enabled di questo criterio su False.

Enabled

Facoltativo

Booleano

Consente di abilitare o disabilitare il filtro per il trasferimento dei file. Se questo parametro è impostato su True, i file con le estensioni specificate (o tutti i file, a seconda del valore specificato per la proprietà Action) non possono essere trasferiti utilizzando un client Lync Server 2010. Se questo parametro è impostato su False, è possibile trasferire qualsiasi file.

Valore predefinito: True.

Extensions

Facoltativo

Modificatore dell'elenco PS

Elenco delle estensioni dei file che verranno bloccate. Se si tenta di utilizzare un client Lync Server 2010 per trasferire un file la cui estensione corrisponde a una di quelle presenti nell'elenco, il trasferimento verrà bloccato e il file non verrà trasferito. Questo elenco viene ignorato, se la proprietà Action è impostata su BlockAll (tutti i trasferimenti sono bloccati) o se la proprietà Enabled è impostata su False (nessun trasferimento è bloccato).

Per impostazione predefinita, nella proprietà Extensions sono incluse le seguenti estensioni: .ade, .adp, .app, .asp, .bas, .bat, .cer, .chm, .cmd, .com, .cpl, .crt, .csh, .exe, .fxp, .grp, .hlp, .hta, .inf, .ins, .isp, .its, .js, .jse, .ksh, .lnk, .mad, .maf, .mag, .mam, .maq, .mar., mas., .mat, .mau, .mav, .maw, .mda, .mdb. .mde, .mdt, .mdw, .mdz, .msc, .msi, .msp, .mst, .ocx, .ops, .pcd, .pif, .pl, .pnp, .prf, .prg, .pst, .reg, .scf, .scr, .sct, .shb, .shs, .tmp, .url, .vb, .vbe, .vbs, .vsd, .vsmacros, .vss, .vst, .vsw, .ws, .wsc. .wsf, .wsh

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate 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

New-CsFileTransferFilterConfiguration consente di creare nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration.

Esempio

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

New-CsFileTransferFilterConfiguration -Identity site:Redmond

Nel comando precedente, viene utilizzato il cmdlet New-CsFileTransferFilterConfiguration per creare una nuova configurazione del filtro di trasferimento dei file di messaggistica istantanea con Identity site:Redmond. Dal momento che non sono stati specificati altri parametri, la configurazione verrà creata utilizzando i valori predefiniti.

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

New-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Add=".ps1"}

In questo comando viene utilizzato il cmdlet New-CsFileTransferFilterConfiguration per creare una nuova configurazione del filtro di trasferimento file con Identity site:Redmond. Dal momento che è stato specificato il parametro Extensions, la nuova configurazione conterrà tutti i valori predefiniti e in più i file con estensione .ps1. Questa nuova estensione viene aggiunta utilizzando il parametro Extensions e il modificatore dell'elenco Add seguito dall'estensione da aggiungere. Si noti che è necessario includere il punto come parte del nome dell'estensione. Per aggiungere più estensioni, è sufficiente separarle con una virgola: @{Add=".ps1",".ps2",".ps3"}

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

New-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Replace=".vbs",".ps1"}

Nell'Esempio 3, viene utilizzato il cmdlet New-CsFileTransferFilterConfiguration per creare una nuova configurazione del filtro di trasferimento file con Identity site:Redmond. Questo esempio è simile all'Esempio 2, ma in questo caso come modificato dell'elenco è stato utilizzato Replace invece di Add. Ciò significa che il gruppo completo di estensioni verrà sostituito dalle due estensioni specificate: .vbs e .ps1. In questo caso, i soli file bloccati sul sito Redmond saranno quelli con estensione .vbs e .ps1.

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

$x = New-CsFileTransferFilterConfiguration -Identity site:Redmond -InMemory 
$x.Action = "BlockAll"
Set-CsFileTransferFilterConfiguration -Instance $x

Nell'Esempio 4 viene illustrato l'utilizzo del parametro InMemory per creare una configurazione del filtro di trasferimento file che inizialmente risiede solo in memoria. Per eseguire questa operazione, il primo comando nell'esempio utilizza il cmdlet New-CsFileTransferFilterConfiguration e il parametro InMemory per creare una nuova configurazione del filtro di trasferimento file con Identity site:Redmond. A questo punto, le nuove impostazioni esistono solo nella memoria e agli utenti presso il sito Redmond vengono ancora applicate le impostazioni globali del filtro per il trasferimento dei file.

Nel secondo comando, il valore della proprietà Action per questa istanza in memoria è impostato su BlockAll. Infine, il terzo comando nell'esempio utilizza il cmdlet Set-CsFileTransferFilterConfiguration per creare la nuova raccolta di impostazioni e applicarle al sito Redmond.

Si noti che è possibile eseguire la stessa operazione in un unico passaggio utilizzando il seguente comando:

New-CsFileTransferFilterConfiguration -Identity site:Redmond –Action "BlockAll"