Start-ManagedFolderAssistant
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ambiente ou de outro.
Use o cmdlet Start-ManagedFolderAssistant para iniciar imediatamente o processamento de gerenciamento de registro de mensagens (MRM) das caixas de correio que você especificar.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Identity (Default)
Start-ManagedFolderAssistant
[-Identity] <MailboxOrMailUserIdParameter>
[-HoldCleanup]
[-AggMailboxCleanup]
[-Confirm]
[-DomainController <Fqdn>]
[-WhatIf]
[<CommonParameters>]
ComplianceBoundaryAssistantParameterSet
Start-ManagedFolderAssistant
[-Identity] <MailboxOrMailUserIdParameter>
[-AdaptiveScope]
[-AggMailboxCleanup]
[-Confirm]
[-FullCrawl]
[-InactiveMailbox]
[-WhatIf]
[<CommonParameters>]
ComplianceJobAssistantParameterSet
Start-ManagedFolderAssistant
[-Identity] <MailboxOrMailUserIdParameter>
[-ComplianceJob]
[-AggMailboxCleanup]
[-Confirm]
[-FullCrawl]
[-InactiveMailbox]
[-WhatIf]
[<CommonParameters>]
DataGovernanceAssistantParameterSet
Start-ManagedFolderAssistant
[-Identity] <MailboxOrMailUserIdParameter>
[-DataGovernance]
[-AggMailboxCleanup]
[-Confirm]
[-FullCrawl]
[-InactiveMailbox]
[-WhatIf]
[<CommonParameters>]
ElcB2DumpsterArchiverAssistantParameterSet
Start-ManagedFolderAssistant
[-Identity] <MailboxOrMailUserIdParameter>
[-B2DumpsterArchiver]
[-AggMailboxCleanup]
[-Confirm]
[-FullCrawl]
[-InactiveMailbox]
[-WhatIf]
[<CommonParameters>]
ElcB2IPMArchiverAssistantParameterSet
Start-ManagedFolderAssistant
[-Identity] <MailboxOrMailUserIdParameter>
[-B2IPMArchiver]
[-AggMailboxCleanup]
[-Confirm]
[-FullCrawl]
[-InactiveMailbox]
[-WhatIf]
[<CommonParameters>]
HoldCleanupParameterSet
Start-ManagedFolderAssistant
[-Identity] <MailboxOrMailUserIdParameter>
[-HoldCleanup]
[-AggMailboxCleanup]
[-Confirm]
[-FullCrawl]
[-InactiveMailbox]
[-WhatIf]
[<CommonParameters>]
StopHoldCleanupParameterSet
Start-ManagedFolderAssistant
[-Identity] <MailboxOrMailUserIdParameter>
[-StopHoldCleanup]
[-AggMailboxCleanup]
[-Confirm]
[-FullCrawl]
[-InactiveMailbox]
[-WhatIf]
[<CommonParameters>]
Description
O Assitente da Pasta Gerenciada usa as configurações de política de retenção das caixas de correio dos usuários para processar a retenção dos itens. Esse processamento de caixas de correio ocorre automaticamente. Você pode usar o cmdlet Start-ManagedFolderAssistant para começar imediatamente a processar a caixa de correio especificada.
No RTM (release to manufacturing) do Exchange Server 2010, o parâmetro Identity especifica o servidor de Caixa de Correio para iniciar o assistente e processar todas as caixas de correio nesse servidor, e o parâmetro Mailbox especifica a caixa de correio a ser processada. No Exchange 2010 Service Pack 1 (SP1) e posterior, o parâmetro Mailbox é removido e o parâmetro Identity aceita a caixa de correio ou o usuário de email para processar.
Se você usar estes parâmetros em scripts ou comandos agendados, recomendamos que você analise-os e faça as alteraçoes necessárias.
Para obter mais informações, consulte KB4032361.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Start-ManagedFolderAssistant -Identity "Chris"
Este exemplo processa a caixa de correio para um usuário com o alias Chris.
Exemplo 2
Get-Mailbox -Anr Chr -DomainController DC01 | Start-ManagedFolderAssistant
Este exemplo usa o comando Get-Mailbox para recuperar todas as caixas de correio resolvidas a partir da pesquisa ANR (resolução de nomes ambíguos) da cadeia de caracteres "Chr" no domínio DC01 (por exemplo, usuários como Chris Ashton, Christian Hess e Christa Geller) são ligados ao comando Start-ManagedFolderAssistant para processamento.
Parâmetros
-AdaptiveScope
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Preencher AdaptiveScope Description }}
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ComplianceBoundaryAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AggMailboxCleanup
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção AggMailboxCleanup especifica a limpeza da caixa de correio agregada. Não é preciso especificar um valor com essa opção.
Esta opção limpa caixas de correio agregadas, auditorias e registro de calendário.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-B2DumpsterArchiver
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Preencher B2DumpsterArchiver Descrição }}
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ElcB2DumpsterArchiverAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-B2IPMArchiver
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Preencher B2IPMArchiver Descrição }}
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ElcB2IPMArchiverAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ComplianceJob
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ComplianceJobAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DataGovernance
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DataGovernanceAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-FullCrawl
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
O comutador FullCrawl recalcula a aplicação de marcas em toda a caixa de correio. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ComplianceBoundaryAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
ComplianceJobAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
DataGovernanceAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
ElcB2DumpsterArchiverAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
ElcB2IPMArchiverAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
HoldCleanupParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
StopHoldCleanupParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-HoldCleanup
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção HoldCleanup instrui o Assistente de Pasta Gerenciada a limpo versões duplicadas de itens na pasta Itens Recuperáveis que podem ter sido criadas quando uma caixa de correio está em Retenção In-Place, Retenção de Litígio ou tem a Recuperação de Item Único habilitada. Não é preciso especificar um valor com essa opção.
A remoção de itens duplicados da pasta Itens Recuperáveis reduz o tamanho da pasta e pode ajudar a evitar que os limites de cota de Itens Recuperáveis sejam atingidos. Para obter mais detalhes sobre os limites de cota de itens recuperáveis, consulte Pasta Itens Recuperáveis no Exchange Server.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
HoldCleanupParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Identity especifica a caixa de correio a ser processada. Nas implantações entre locais, você também pode especificar um usuário de email que tem uma caixa de correio na nuvem. É possível usar qualquer valor que identifique a caixa de correio ou o usuário de email com exclusividade. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- Domínio\Nome de usuário
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Observação: no serviço baseado em nuvem, se você receber um erro, tente usar o GUID da caixa de correio para o valor desse parâmetro. Você pode obter o valor GUID da caixa de correio substituindo <UserIdentity> pelo endereço de email do usuário e executando o seguinte comando: Get-Mailbox -User <UserIdentity> | Format-List *GUID,MailboxLocations
Propriedades do parâmetro
| Tipo: | MailboxOrMailUserIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-InactiveMailbox
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
O comutador InactiveMailbox executa o comando somente em caixas de correio inativas. Não é preciso especificar um valor com essa opção.
Uma caixa de correio inativa é uma caixa de correio colocada em Suspensão de Litigação ou Suspensão no Local antes de uma exclusão reversível. O conteúdo de uma caixa de correio inativa é preservado até que a retenção seja removida.
Ao usar essa opção, os itens não são movidos da caixa de correio inativa para a caixa de correio de arquivo morto.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ComplianceBoundaryAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
ComplianceJobAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
DataGovernanceAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
ElcB2DumpsterArchiverAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
ElcB2IPMArchiverAssistantParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
HoldCleanupParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
StopHoldCleanupParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-StopHoldCleanup
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
O comutador StopHoldCleanup interrompe um comando de limpeza de retenção anterior emitido na caixa de correio. Não é preciso especificar um valor com essa opção.
Um comando de limpeza de espera é executado até que ele verifique completamente a pasta Itens Recuperáveis em busca de versões duplicadas de itens (ele continua mesmo após uma interrupção). Em alguns casos, o comando de limpeza de espera fica travado, o que pode bloquear outras tarefas regulares do MRM na caixa de correio (por exemplo, itens expirados). O switch StopHoldCleanup informa ao MRM para abandonar a tarefa de limpeza de retenção travada para que as tarefas regulares possam continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
StopHoldCleanupParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.