Condividi tramite

  • Articolo

Set-CsFileTransferFilterConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Modifica una raccolta di impostazioni di configurazione del filtro di trasferimento file. Le impostazioni 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 i client Microsoft Lync Server 2010.

Sintassi

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

Set-CsFileTransferFilterConfiguration [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Quando si inviano messaggi istantanei, gli utenti possono allegare e inviare file agli altri partecipanti alla conversazione. Lync Server 2010 può essere configurato in modo da impedire l'invio dai client di file con determinate estensioni, generalmente riferite a tipi di file che possono rivelarsi dannosi.

La capacità degli utenti di trasferire file con i client Lync Server 2010 è determinata dalle impostazioni di configurazione del filtro di trasferimento file applicate negli ambiti globale o (facoltativamente) del sito. Il cmdlet Set-CsFileTransferFilterConfiguration consente di modificare la configurazione del filtro di trasferimento file esistente. È possibile modificare l'elenco di estensioni che saranno bloccate sia aggiungendo o rimuovendo le estensioni, sia creando un elenco del tutto nuovo. È inoltre possibile utilizzare questo cmdlet per stabilire se il filtro di trasferimento file è abilitato e a quale livello (blocco dei soli file con estensioni corrispondenti a quelle nell'elenco Estensioni o blocco di tutti i file).

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-CsFileTransferFilterConfiguration 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 "Set-CsFileTransferFilterConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Identificatore univoco della configurazione di trasferimento file da modificare. Questo valore può essere global o site:<nome sito>, dove <nome sito> corrisponde al nome del sito a cui applicare le impostazioni, ad esempio site:Redmond.

Se questo parametro non viene specificato, per impostazione predefinita Set-CsFileTransferFilterConfiguration aggiorna le impostazioni globali.

Instance

Facoltativo

FileTransferFilterConfiguration

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. Questo oggetto deve essere di tipo FileTransferFilterConfiguration e può essere recuperato chiamando il cmdlet Get-CsFileTransferFilterConfiguration.

Action

Facoltativo

Stringa

Consente di stabilire l'azione da intraprendere se la configurazione per il filtro di trasferimento file è abilitata. Se l'impostazione è BlockAll vengono vietati tutti i trasferimenti di file, indipendentemente dall'estensione del file. Se l'impostazione è Block (valore predefinito), i trasferimenti di file sono ammessi, a meno che l'estensione del file non sia presente tra i tipi di file proibiti nella 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 per questo criterio su False.

Enabled

Facoltativo

Booleano

Consente di abilitare o disabilitare il filtro di trasferimento file. Se questo parametro è impostato su True, i file con le estensioni specificate (o tutti i file, a seconda del valore della proprietà Action) non potranno essere trasferiti dal client. Se questo parametro è impostato su False, potranno essere trasferiti tutti i file.

Valore predefinito: True.

Extensions

Facoltativo

Elenco di stringhe

Elenco delle estensioni dei file che saranno 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. L'elenco viene ignorato se Action è impostato su BlockAll (tutti i trasferimenti di file sono bloccati) o se Enabled è impostato su False (nessun trasferimento di file viene bloccato).

Per impostazione predefinita, nella proprietà Extensions sono incluse le seguenti estensioni di file: .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

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.FileTransferFilterConfiguration. Consente di accettare l'input da pipeline di oggetti configurazione del filtro di trasferimento file.

Tipi restituiti

Questo cmdlet non restituisce un valore o un oggetto. In realtà, il cmdlet configura istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration.

Esempio

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

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

Con il comando mostrato nell'esempio 1 viene disabilitato il filtro di trasferimento file per il sito Redmond (vale a dire la configurazione del filtro di trasferimento file con identità site:Redmond). Per eseguire questa operazione, nel comando è incluso il parametro Enabled impostato su $False.

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

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

Con i comandi precedenti viene aggiunta una nuova estensione di file (PS1, l'estensione dei file di script di Windows PowerShell) all'elenco di estensioni di file vietate nel sito Redmond. Per aggiungere la nuova estensione di file, Set-CsFileTransferFilterConfiguration utilizza il parametro Extensions e il modificatore di elenco Add. Il modificatore consente di aggiungere l'estensione di file specificata (PS1) all'elenco di estensioni vietate. Per aggiungere più estensioni con un singolo comando, separare le estensioni di file con le virgole: @{Add=".ps1",".ps2",".ps3"}. È necessario includere il punto quando si specifica un'estensione di file.

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

Get-CsFileTransferFilterConfiguration | Set-CsFileTransferFilterConfiguration -Extensions @{Add=".ps1"}

Con l'esempio 3, l'estensione di file PS1 viene aggiunta all'elenco Extensions per tutte le configurazioni del filtro di trasferimento file attualmente in uso nell'organizzazione. Per ottenere tale risultato, viene chiamato per prima cosa Get-CsFileTransferFilterConfiguration, senza parametri aggiuntivi, per restituire una raccolta di tutte le configurazioni del filtro di trasferimento file attualmente in uso. La raccolta viene quindi inviata tramite pipe a Set-CsFileTransferFilterConfiguration, che aggiunge l'estensione di file PS1 a ciascun elemento nella raccolta.

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

Set-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Remove=".ps1"}

Con l'esempio precedente, l'estensione del file PS1 viene rimossa dall'elenco di estensioni bloccate dalla configurazione del filtro di trasferimento file per il sito Redmond. Questo esempio è identico all'esempio 3, tranne per il fatto che, invece di chiamare il modificatore di elenco Add per aggiungere un'estensione all'elenco, viene chiamato il modificatore di elenco Remove per rimuovere un'estensione dall'elenco.

-------------------------- Esempio 5 --------------------------

$a = Get-CsFileTransferFilterConfiguration -Identity site:Redmond
$a.Extensions.Remove(".ps1")
Set-CsFileTransferFilterConfiguration -Instance $a

Con l'esempio 5 viene eseguita la stessa operazione dell'esempio 4, vale a dire la rimozione dell'estensione PS1 dall'elenco di estensioni del filtro di trasferimento file per il sito Redmond. Tuttavia, in questo caso viene prima recuperata la configurazione del filtro di trasferimento file per site:Redmond e l'output viene assegnato alla variabile $a, che ora contiene la configurazione per il sito Redmond. Successivamente, viene recuperata la proprietà Extensions di $a, vale a dire la proprietà Extensions di site:Redmond ($a.Extensions). Questa proprietà contiene l'elenco delle estensioni di file. Dopo la proprietà Extensions viene inserita una chiamata al metodo Remove ($a.Extensions.Remove). Viene passato il valore .ps1 al metodo Remove; in questo modo è possibile rimuovere tale estensione dall'elenco nella proprietà Extensions. Tuttavia, con questa operazione l'estensione è stata rimossa solo dall'archivio di configurazione in memoria nella variabile $a. Per apportare la modifica al database è necessario chiamare Set-CsFileTransferFilterConfiguration, passando $a al parametro Instance.