Condividi tramite

  • Articolo

Get-CsFileTransferFilterConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce le configurazioni del filtro per il trasferimento dei file nell'organizzazione. Queste configurazioni vengono utilizzate per impedire a un utente di trasferire determinati tipi di file (ad esempio, file con estensione .vbs o .ps1) utilizzando un client Microsoft Lync Server 2010.

Sintassi

Get-CsFileTransferFilterConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsFileTransferFilterConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Quando inviano messaggi immediati, gli utenti possono allegare e inviare file ad altri partecipanti alla conversazione. È possibile configurare Lync Server 2010 in modo che non sia consentito l'invio di file con determinate estensioni (generalmente quelle legate a tipi di file potenzialmente pericolosi) utilizzando un client Lync Server 2010.

Il cmdlet Get-CsFileTransferFilterConfiguration consente di recuperare le impostazioni per una particolare raccolta di impostazioni (queste impostazioni possono essere configurate nell'ambito globale o del sito). Le configurazioni di filtro per il trasferimento dei file includono l'elenco delle estensioni dei file per i quali è bloccato il trasferimento, a quale grado di filtro è abilitato (sono bloccati tutti i trasferimenti di file o solo quei file con le estensioni specificate) e se il filtro per il trasferimento dei file è attivo.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Identificatore univoco per la configurazione per il trasferimento dei file che si vuole recuperare. Per ottenere le impostazioni globali, utilizzare la seguente sintassi: -Identity global. Per ottenere le impostazioni configurate nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Si noti che non è consentito utilizzare i caratteri jolly per specificare l'identità. Se si desidera utilizzare i caratteri jolly, utilizzare invece il parametro Filter.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per specificare le configurazioni di filtro per il trasferimento dei file da ottenere. Ad esempio, per restituire tutte le configurazioni di filtro per il trasferimento dei file nell'ambito del sito, utilizzare la seguente sintassi: -Filter "site:*". Per impostazione predefinita, le configurazioni di trasferimento dei file con una identità (la sola proprietà che si possa filtrare) che inizia con il valore di stringa "site:" sono impostazioni configurate nell'ambito del sito.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare le configurazioni di filtro per il trasferimento dei file dalla copia locale di archivio di gestione centrale invece che da archivio di gestione centrale.

Tipi di input

Nessuno.

Tipi restituiti

Get-CsFileTransferFilterConfiguration restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration.

Esempio

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

Get-CsFileTransferFilterConfiguration

Il comando riportato nell'Esempio 1 restituisce una raccolta di tutte le configurazioni di filtro per il trasferimento dei file configurate per l'utilizzo nella propria organizzazione. Questo è il comportamento predefinito ogni volta che si utilizza Get-CsFileTransferFilterConfiguration senza qualsiasi parametro aggiuntivo.

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

Get-CsFileTransferFilterConfiguration -Identity site:Redmond

L'esempio precedente restituisce una singola raccolta di configurazioni di filtro per il trasferimento dei file: la configurazione con Identity site:Redmond. Poiché le identità devono essere univoche, il comando non restituirà mai più di una configurazione.

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

Get-CsFileTransferFilterConfiguration -Filter site:*

L'Esempio 3 utilizza il parametro Filter per ottenere una raccolta di tutte le configurazioni del filtro per il trasferimento dei file a livello di sito. Il valore del filtro "site:*" indica a Get-CsFileTransferFilterConfiguration di restituire solo quelle raccolte di impostazioni in cui l'identità inizia con la stringa "site:".

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

Get-CsFileTransferFilterConfiguration | Where-Object {$_.Extensions -contains ".xls"}

Il comando riportato nell'Esempio 4 restituisce solo quelle configurazioni di filtro per il trasferimento dei file che includono .xls nell'elenco delle estensioni proibite. Per ottenere questo risultato, viene utilizzato prima il cmdlet Get-CsFileTransferFilterConfiguration per ottenere una raccolta di tutti i criteri configurati per l'utilizzo nell'organizzazione. Quella raccolta viene poi inviata al cmdlet Where-Object che applica il filtro per restringere i dati restituiti solo a quelle configurazioni nelle quali la proprietà Extensions include (-contains) il valore di stringa ".xls".

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

Get-CsFileTransferFilterConfiguration | Where-Object {$_.Enabled -eq $False}

Il comando precedente restituisce tutte le configurazioni di configurazione per il filtro di diagnostica attualmente disabilitate. Per ottenere questo risultato, viene utilizzato prima il cmdlet Get-CsFileTransferFilterConfiguration per ottenere una raccolta di tutte le configurazioni in uso nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona unicamente le impostazioni in cui la proprietà Enabled equivale a (-eq) True ($True).

-------------------------- Esempio 6 --------------------------

Get-CsFileTransferFilterConfiguration -Identity Global | Select-Object -ExpandProperty Extensions

L'Esempio 6 mostra un elenco completo delle estensioni dei file proibite dalle configurazioni di filtro per il trasferimento dei file globali. Il comando utilizza il cmdlet Get-CsFileTransferFilterConfiguration specificando le raccolte di impostazioni Global. Questi dati vengono quindi inviati tramite pipe al cmdlet Select-Object che utilizza il parametro ExpandProperty per "espandere" il valore della proprietà Extensions. Viene così prodotto un elenco completo delle estensioni dei file visualizzato sullo schermo, una riga per estensione.