Update-StoreMailboxState

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Update-StoreMailboxState para sincronizar o estado da caixa de correio para uma caixa de correio no repositório de caixas de correio do Exchange com o estado da conta de usuário do Active Directory correspondente.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Update-StoreMailboxState
      -Database <DatabaseIdParameter>
      -Identity <StoreMailboxIdParameter>
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Description

O cmdlet Update-StoreMailboxState força o estado do repositório de caixas de correio no armazenamento do Exchange a ser sincronizado com o Active Directory. Em alguns casos, é possível que o estado do repositório de uma caixa de correio não esteja sincronizado com o estado da conta de usuário do Active Directory correspondente. Isso pode resultar da latência de replicação do Active Directory. Por exemplo, se uma conta de usuário habilitada para caixa de correio estiver desabilitada no Active Directory, mas não estiver marcada como desabilitada no repositório de caixa de correio do Exchange. Nesse caso, executar Update-StoreMailboxState sincronizará o estado do repositório da caixa de correio com o estado da conta de usuário do Active Directory e marcar a caixa de correio como desabilitada, no repositório da caixa de correio. Você pode usar esse comando para solucionar problemas que podem ser resultado de um estado inesperado para uma caixa de correio ou se você suspeitar de que o estado do repositório for diferente do estado da conta do Active Directory correspondente.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico 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

Update-StoreMailboxState -Database MDB01 -Identity 4a830e3f-fd07-4629-baa1-8bce16b86d88

Este exemplo atualiza o estado da caixa de correio de uma caixa de correio localizada no banco de dados de caixa de correio MDB01 e cuja GUID é 4a830e3f-fd07-4629-baa1-8bce16b86d88.

Exemplo 2

Get-MailboxStatistics -Database MDB02 | ForEach { Update-StoreMailboxState -Database $_.Database -Identity $_.MailboxGuid -Confirm:$false }

Este exemplo atualiza o estado de todas as caixas de correio no banco de dados de caixa de correio MDB02.

Exemplo 3

Get-MailboxStatistics -Database MDB03 | Where { $_.DisconnectReason -ne $null } | ForEach { Update-StoreMailboxState -Database $_.Database -Identity $_.MailboxGuid -Confirm:$false }

Este exemplo atualiza o estado de todas as caixas de correio desconectadas no banco de dados de caixa de correio MDB03.

Parâmetros

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets 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 confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
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

-Database

O parâmetro Database especifica o banco de dados da caixa de correio que contém a caixa de correio. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID
Type:DatabaseIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identity especifica a caixa de correio que você deseja atualizar. Use o GUID da caixa de correio como o valor desse parâmetro.

Execute o seguinte comando para obter a caixa de correio GUID e outras informações para todas as caixas de correio em sua organização: Get-MailboxDatabase | Get-MailboxStatistics | Format-List DisplayName, MailboxGuid, Database, DisconnectReason, DisconnectDate.

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

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

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

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.

Observações

Em um cenário em que uma caixa de correio é movida para outro banco de dados, então a caixa de correio é imediatamente desabilitada, há um atraso de 24 horas para permitir a replicação.

Nesse cenário, Update-StoreMailboxState pode não atualizar imediatamente DisconnectState e DisconnectReason ao executar Get-MailboxStatistics. As estatísticas da caixa de correio serão atualizadas aproximadamente 24 horas após a mudança.