Condividi tramite

  • Articolo

Remove-CsFileTransferFilterConfiguration

 

Ultima modifica dell'argomento: 2012-03-25

Rimuove la configurazione specificata del filtro di trasferimento dei file di messaggistica istantanea. Le impostazioni del filtro di trasferimento dei file di messaggistica istantanea consentono di impedire a un utente di trasferire determinati tipi di file mediante la messaggistica istantanea.

Sintassi

Remove-CsFileTransferFilterConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Durante l'invio di messaggi istantanei, gli utenti possono allegare e inviare file agli altri partecipanti alla conversazione. Tuttavia è possibile configurare Microsoft Lync Server 2010 in modo che i file con determinate restrizioni, in genere le estensioni dei tipi di file che possono essere potenzialmente dannosi, non possano essere inviati tramite un client Lync Server 2010.

Il cmdlet Remove-CsFileTransferFilterConfiguration consente di eliminare la configurazione di un filtro di trasferimento di file. Nel caso di configurazioni nell'ambito del sito, verranno rimosse da Remove-CsFileTransferFilterConfiguration e gli utenti del sito erediteranno automaticamente la configurazione globale del filtro di trasferimento dei file. Remove-CsFileTransferFilterConfiguration può anche essere eseguito in relazione alla configurazione globale. In questo caso, però, la configurazione globale non verrà rimossa; in realtà, per tutti i valori delle proprietà in tale configurazione verranno ripristinati i valori predefiniti.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet Remove-CsFileTransferFilterConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsFileTransferFilterConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identificatore univoco della configurazione del trasferimento dei file da rimuovere. Per fare riferimento alla configurazione globale, utilizzare la seguente sintassi: -Identity global. Per fare riferimento a una configurazione nell'ambito del sito, utilizzare una sintassi analoga alla seguente: -Identity site:Redmond. Non è possibile utilizzare valori con caratteri jolly per specificare un'identità.

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. Accetta l'invio tramite pipe di oggetti di configurazione del filtro di trasferimento dei file.

Tipi restituiti

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

Esempio

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

Remove-CsFileTransferFilterConfiguration -Identity site:Redmond

Nell'esempio precedente Remove-CsFileTransferFilterConfiguration viene utilizzato per rimuovere la configurazione del filtro di trasferimento dei file con identità site:Redmond.

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

Get-CsFileTransferFilterConfiguration -Filter site:* | Remove-CsFileTransferFilterConfiguration

Nell' esempio 2 vengono rimosse tutte le configurazioni del filtro di trasferimento dei file nell'ambito del sito. Per eseguire questa attività, viene utilizzato prima Get-CsFileTransferFilterConfiguration e il parametro Filter per restituire tutte le configurazioni nell'ambito del sito. Il valore del filtro "site:*" indica a Get-CsFileTransferFilterConfiguration di restituire solo quelle configurazioni in cui l'identità inizia con la stringa "site:". La raccolta filtrata delle configurazioni viene quindi inviata tramite pipe a Remove-CsFileTransferFilterConfiguration, che elimina ogni elemento nella raccolta.

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

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

Con l'esempio 3 viene mostrato come rimuovere tutte le configurazioni del filtro di trasferimento dei file che sono attualmente disabilitate. Per questo scopo, viene utilizzato prima Get-CsFileTransferFilterConfiguration per restituire una raccolta di tutte le configurazioni del filtro di trasferimento dei file che sono attualmente in uso nell'organizzazione. Tali informazioni vengono quindi inviate tramite pipe al cmdlet Where-Object, che seleziona solo le configurazioni di trasferimento dei file in cui la proprietà Enabled è uguale a (-eq) False ($False). La raccolta filtrata delle impostazioni viene quindi inviata tramite pipe a Remove-CsFileTransferFilterConfiguration, che procede a rimuovere ogni elemento nella raccolta filtrata.