Export-TransportRuleCollection

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.

Usare il cmdlet Export-TransportRuleCollection per esportare le regole di trasporto nell'organizzazione.

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

Sintassi

Export-TransportRuleCollection
      [[-Identity] <RuleIdParameter>]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-Format <RuleCollectionFormat>]
      [-ExportLegacyRules]
      [-WhatIf]
      [<CommonParameters>]

Descrizione

Usare il cmdlet Export-TransportRuleCollection per esportare le raccolte di regole di trasporto nell'organizzazione. Il formato della raccolta di regole di trasporto esportate è stato modificato in Exchange Server 2013. Il nuovo formato non può essere importato in Exchange Server 2010.

Il processo di esportazione delle raccolte di regole si svolge in due fasi. Prima si esportano le raccolte di regole in una variabile poi si utilizza il cmdlet Set-Content per scrivere i dati in un file XML. Per altre informazioni, vedere Set-Content.For more information, see Set-Content.

È 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

$file = Export-TransportRuleCollection

[System.IO.File]::WriteAllBytes('C:\My Docs\Rules.xml', $file.FileData)

Questo esempio esporta le regole di trasporto. I dati delle regole vengono prima esportati nella variabile $file e quindi scritti nel file XML Rules.xml nella cartella C:\My Docs.

Esempio 2

$file = Export-TransportRuleCollection -ExportLegacyRules

[System.IO.File]::WriteAllBytes('C:\My Docs\LegacyRules.xml', $file.FileData)

In Exchange Server 2010, questo esempio esporta le regole di trasporto legacy create in Exchange 2007 in un file XML. Il primo comando usa l'opzione ExportLegacyRules per esportare le regole di trasporto legacy nella variabile denominata $file. Il secondo passaggio salva i dati esportati nel file XML denominato LegacyRules.xml.

È possibile importare la raccolta di regole esportate in Exchange 2010 usando il cmdlet Import-TransportRuleCollection.

È necessario eseguire questi comandi in questo esempio in un server Trasporto hub di Exchange 2010.

Parametri

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.

Type:	SwitchParameter
Aliases:	cf
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

-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

-ExportLegacyRules

Questo parametro è disponibile solo in Exchange Server 2010.

L'opzione ExportLegacyRules è necessaria per esportare le regole di trasporto da Exchange 2007. Con questa opzione non è necessario specificare alcun valore.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Format

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro Format specifica il formato della raccolta di regole di trasporto esportate. I valori validi sono:

RuleCollectionXML
InternalXML
DlpMigrationRuleCollection

Type:	RuleCollectionFormat
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Identity

Questo parametro funziona solo in Exchange Server 2010.

Il parametro Identity consente di specificare la regola di trasporto da esportare. È 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

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Type:	SwitchParameter
Aliases:	wi
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.

Condividi tramite