Update-SiteMailbox

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

Use o cmdlet Update-SiteMailbox para disparar uma sincronização do Microsoft SharePoint. Este comando sincroniza a associação e as permissões do conteúdo do documento no Microsoft Exchange. Talvez seja necessário executar essa ação ao solucionar problemas de sincronização de documentos ou associação.

As caixas de correio de site foram preteridas no Exchange Online e no SharePoint Online em 2017. Para obter mais informações, consulte Preterição de Caixas de Correio de Sites.

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

Sintaxe

Default (Default)

Update-SiteMailbox
    [-Identity] <RecipientIdParameter>
    [-BypassOwnerCheck]
    [-Confirm]
    [-FullSync]
    [-Organization <OrganizationIdParameter>]
    [-Server <String>]
    [-Target <TargetType>]
    [-WhatIf]
    [<CommonParameters>]

Description

Se você estiver executando este comando em uma caixa de correio de site de que você não é proprietário, você precisará usar o parâmetro BypassOwnerCheck para executar esse cmdlet.

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

Update-SiteMailbox -BypassOwnerCheck -Identity "MarketingEvents 2013"

Este exemplo atualiza a caixa de correio de site MarketingEvents 2013. Se você não especificar o destino, a sincronização do documento e da associação será disparada. Como o parâmetro BypassOwnerCheck é usado, não é necessário ser um proprietário ou membro da caixa de correio de site para executar este cmdlet.

Exemplo 2

Update-SiteMailbox -BypassOwnerCheck -Identity WinterHoliday@tailspintoys.com -FullSync

Este exemplo atualiza a caixa de correio WinterHoliday@tailspintoys.com do site e executa uma sincronização completa. Por padrão, a atualização ocorre apenas para sincronização a partir da última sincronização. Isso só é aplicável para a sincronização de documentos

Parâmetros

-BypassOwnerCheck

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro BypassOwnerCheck é usado quando a conta que está executando o comando não é membro ou proprietária da caixa de correio do site. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção e não for membro ou proprietário da caixa de correio do site, o comando falhará.

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

-Confirm

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

-FullSync

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O comutador FullSync especifica uma sincronização completa. Não é preciso especificar um valor com essa opção.

As sincronizações completas são caras e afetam o desempenho do sistema do Exchange.

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

-Identity

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Identity especifica a caixa de correio do site que você deseja atualizar. Você pode usar qualquer valor que identifique exclusivamente a caixa de correio do site. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Propriedades do parâmetro

Tipo:RecipientIdParameter
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

-Organization

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Esse parâmetro está reservado para uso interno da Microsoft.

Propriedades do parâmetro

Tipo:OrganizationIdParameter
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

-Server

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Server especifica o FQDN (nome de domínio totalmente qualificado) ou o servidor do Microsoft SharePoint no qual a caixa de correio do site está localizada.

Propriedades do parâmetro

Tipo:String
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

-Target

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Target especifica se os documentos do SharePoint, a lista de associação da caixa de correio do site ou ambos devem ser atualizados. Não é possível usar este parâmetro com o parâmetro IncludedRecipients ou qualquer um dos parâmetros Conditional.

  • Todos
  • Documento
  • Associação

Se você não especificar esse parâmetro quando executar o cmdlet, esse valor de parâmetro será padronizado como ALL.

Propriedades do parâmetro

Tipo:TargetType
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

-WhatIf

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.