Compartilhar via


Start-ManagedFolderAssistant

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-06-28

Use o cmdlet Start-ManagedFolderAssistant para iniciar imediatamente o processamento do MRM (Gerenciamento de Registros de Mensagens) de caixas de correio nos servidores especificados.

Sintaxe

Start-ManagedFolderAssistant [-Identity <ServerIdParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Start-ManagedFolderAssistant [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Mailbox <MailboxIdParameter>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O Assistente de Pasta Gerenciada usa as configurações de pasta gerenciada e as configurações de Diretiva de Caixa de Correio de Pasta Gerenciada de caixas de correio de usuários para processar a retenção de itens e para registrar em diário as informações, conforme for necessário. Esse processamento de caixa de correio pode ocorrer em horários agendados ou sob demanda.

Se o comando for inserido sem parâmetros, o Assistente de Pasta Gerenciada processará todas as caixas de correio no servidor local. Se um ou mais nomes de servidor forem especificados como valores do parâmetro Identity, as caixas de correio nos servidores especificados serão processadas.

Para executar o cmdlet Start-ManagedFolderAssistant, você deve usar uma conta à qual esteja delegado o seguinte:

  • Função de Administrador do Exchange Server e grupo Administradores local para o servidor de destino

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

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

O parâmetro DomainController especifica o controlador de domínio a ser usado para gravar essa alteração de configuração no Active Directory. Use o nome de domínio totalmente qualificado (FQDN) do controlador de domínio a ser usado.

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

O parâmetro Identity especifica os nomes de servidores nos quais as caixas de correio devem ser processadas. Se um servidor não estiver especificado, as caixas de correio no servidor local serão processadas. O parâmetro Identity não pode ser usado em combinação com o parâmetro Mailbox.

Mailbox

Opcional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

O parâmetro Mailbox especifica uma caixa de correio individual a ser processada. A caixa de correio é especificada como um endereço de email, um domínio\nome do usuário ou uma GUID de caixa de correio. O parâmetro Mailbox não pode ser usado em combinação com o parâmetro Identity.

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á exibir 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

Os exemplos de código a seguir mostram como usar o comando Start-ManagedFolderAssistant:

  • No primeiro exemplo, o comando Start-ManagedFolderAssistant é usado sem parâmetros e todas as caixas de correio no servidor local são processadas.

  • No segundo exemplo, o comando Start-ManagedFolderAssistant é usado para dois servidores.

  • No terceiro exemplo, a caixa de correio de um usuário que tenha o álias Chris é processada.

  • No quarto exemplo, todas as caixas de correio que resolvem a partir da pesquisa de resolução de nomes ambíguos da cadeia de caracteres "Chr" que estão no domínio de DC01 (por exemplo, usuários como Chris Ashton, Christian Cletus e Christa Geller) são canalizados ao comando Start-ManagedFolderAssistant para processamento.

Start-ManagedFolderAssistant
Start-ManagedFolderAssistant -Identity ExchSrvr1, ExchSrvr2
Start-ManagedFolderAssistant -Mailbox Chris
Get-Mailbox -Anr Chr -DomainController DC01 | Start-ManagedFolderAssistant 

O comando Start-ManagedFolderAssistant pode ser usado sem parâmetros, com o parâmetro Identity ou com o parâmetro Mailbox. Entretanto, não é possível usar o comando Start-ManagedFolderAssistant com os parâmetros Identity e Mailbox.