Get-TransportRule

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Utilizzare il cmdlet Get-TransportRule per visualizzare le regole di trasporto (regole del flusso di posta) nell'organizzazione.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Get-TransportRule
   [[-Identity] <RuleIdParameter>]
   [-DomainController <Fqdn>]
   [-State <RuleState>]
   [-DlpPolicy <String>]
   [-ExcludeConditionActionDetails <Boolean>]
   [-Filter <String>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Descrizione

Nei server Cassette postali questo cmdlet restituisce tutte le regole nell'organizzazione di Exchange archiviate in Active Directory. In un server Trasporto Edge questo cmdlet restituisce solo le regole configurate nel server locale.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Get-TransportRule

In questo esempio viene restituito un elenco riepilogativo di tutte le regole presenti nell'organizzazione.

Esempio 2

Get-TransportRule "Ethical Wall - Sales and Brokerage Departments" | Format-List

Questo esempio restituisce informazioni dettagliate sulla regola "Ethical Wall - Sales and Brokerage Departments".

Per altre informazioni sul pipelining, vedere Informazioni sulle pipeline. Per altre informazioni su come usare l'output di un comando, vedere Uso dell'output dei comandi.

Esempio 3

Get-TransportRule -DlpPolicy "PII (U.S.)"

In questo esempio viene restituito un elenco riepilogativo delle regole utilizzate per applicare il criterio DLP PII (U.S.) nell'organizzazione.

Esempio 4

Get-TransportRule | Where {$_.DlpPolicy -ne $null}

In questo esempio viene restituito un elenco riepilogativo di tutte le regole utilizzate per applicare il criterio DLP PII (U.S.) nell'organizzazione.

Parametri

-DlpPolicy

Il parametro DlpPolicy filtra i risultati in base al nome del criterio DLP specificato. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

I criteri DLP nell'organizzazione consentono di impedire la divulgazione involontaria di informazioni sensibili. Ogni criterio DLP viene applicato utilizzando un set di regole di trasporto.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Il parametro DomainController non è supportato sui server Trasporto Edge. Un server Trasporto Edge usa l'istanza locale di Active Directory Lightweight Directory Services (AD LDS) per leggere e scrivere i dati.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExcludeConditionActionDetails

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro ExcludeConditionActionDetails specifica se nascondere dettagli specifici dai risultati. I valori validi sono:

  • $true: le proprietà Descrizione, Condizioni e Azioni, nonché i valori delle proprietà di condizione, eccezione e azione configurati sono vuoti.
  • $false: non sono nascosti valori di proprietà o proprietà. Questo è il valore predefinito.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Filter

Il parametro Filter filtra i risultati usando un OPATH. Tale parametro cerca la proprietà Description che include le condizioni, le eccezioni, le azioni e i valori associati di una regola di trasporto.

Questo parametro usa la sintassi "Description -like 'Text*'". Ad esempio, "Description -like '192.168.1.1*'".

Per informazioni dettagliate sui filtri OPATH in Exchange, vedere Informazioni aggiuntive sulla sintassi OPATH.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Identity

Il parametro Identity consente di specificare la regola che si desidera visualizzare. È possibile utilizzare qualsiasi valore che identifichi la regola in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID
Type:RuleIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ResultSize

Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le richieste che soddisfano la query, impostare questo parametro sul valore unlimited. Il valore predefinito è 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-State

Il parametro State consente di specificare i filtri per visualizzare i risultati in base alle regole abilitate o disabilitate. I valori validi sono:

  • Enabled: solo le regole abilitate vengono incluse nei risultati.
  • Disabled: solo le regole disabilitate vengono incluse nei risultati.

Se il parametro non viene utilizzato, il comando restituisce tutte le regole sia abilitate che disabilitate.

Type:RuleState
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.