Import-TransportRuleCollection
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2007-07-27
Use o cmdlet Import-TransportRuleCollection para importar uma coleção de regras de transporte exportada anteriormente para ser usada pelo agente de Regras de Transporte em um computador em que a função de servidor Transporte de Hub ou a função de servidor Transporte de Borda do Microsoft Exchange Server 2007 esteja instalada.
Sintaxe
Import-TransportRuleCollection -FileName <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
O cmdlet Import-TransportRuleCollection importa uma coleção de regras de transporte exportada anteriormente para ser usada pelo agente de Regras de Transporte.
Aviso
A importação de uma coleção de regras de transporte de um arquivo XML remove ou sobrescreve todas as regras de transporte preexistentes que foram definidas pelo agente de Regras de Transporte. Verifique se você tem o backup de sua coleção de regras de transporte atual antes de importar e sobrescrever suas regras de transporte atuais.
Nos servidores de Transporte de Hub, o comando Import-TransportRuleCollection sobrescreve todas as regras de transporte que são configurados na organização do Exchange 2007, exceto as regras de transporte em servidores de Transporte de Borda. Nos servidores de Transporte de Borda, esse comando sobrescreve apenas as regras de transporte configuradas no computador local.
Para informações sobre como exportar uma coleção de regras de transporte para um arquivo XML, consulte Export-TransportRuleCollection.
Para obter informações sobre o agente de Regras de Transporte, consulte Visão geral de regras de transporte.
Para executar o cmdlet Import-TransportRuleCollection, você deve usar uma conta à qual estejam delegadas as seguintes funções:
- Função Administrador da Organização do Exchange
Para executar o cmdlet Import-TransportRuleCollection em um computador no qual a função de servidor Transporte de Borda está instalada, você deve fazer logon usando uma conta que seja membro do grupo Administradores local nesse computador.
Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange 2007, consulte Considerações sobre permissão.
Parâmetros
| Parâmetro | Necessário | Tipo | Descrição |
|---|---|---|---|
FileName |
Necessário |
System.String |
Use esse parâmetro para especificar o caminho completo e o nome do arquivo XML a importar. Se o caminho ou o nome do arquivo contiver espaços, coloque toda a cadeia de caracteres entre aspas. Por exemplo, |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que recupera dados do serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. O parâmetro DomainController não tem suporte em computadores que executam a função de servidor Transporte de Borda. A função de servidor Transporte de Borda grava somente na instância local do ADAM (Modo de Aplicativo do Active Directory). |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá visualizar quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
|
Exceções
| Exceções | Descrição |
|---|---|
|
|
Exemplo
O exemplo de código a seguir mostra a sintaxe do comando Import-TransportRuleCollection.
Import-TransportRuleCollection -FileName "c:\transport rules\new transport rules.xml"