Connect-Mailbox

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

Use o cmdlet Connect-Mailbox para conectar caixas de correio desconectadas a contas de usuário existentes que ainda não têm caixas de correio.

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

Syntax

Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-Equipment]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       -LinkedDomainController <Fqdn>
       -LinkedMasterAccount <UserIdParameter>
       [-LinkedCredential <PSCredential>]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-Room]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-Shared]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-ValidateOnly]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-User <UserIdParameter>]
       [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
       [-AllowLegacyDNMismatch]
       [-Archive]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-WhatIf]
       [<CommonParameters>]

Description

Se você vincular uma caixa de correio a uma conta de usuário existente, essa conta de usuário terá acesso total à caixa de correio e a todos os emails na caixa de correio.

Se você usar o parâmetro Usuário para especificar a conta de usuário, especifique a conta correta. Se você não usar o parâmetro Usuário, recomendamos que você use a opção ValidateOnly para verificar a qual conta de usuário a caixa de correio tentará se conectar.

Não há nenhum cmdlet Disconnect-Mailbox. Você pode usar os cmdlets Disable-Mailbox ou Remove-Mailbox para desconectar efetivamente as caixas de correio das contas de usuário.

Use o cmdlet Disable-Mailbox para:

  • Desconecte a caixa de correio da conta de usuário.
  • Mantenha a caixa de correio no estado desabilitado antes de ser excluída permanentemente, sujeita ao período de retenção de caixa de correio excluído.
  • Mantenha a conta do usuário, mas remova os atributos do Exchange da conta.

Use o cmdlet Remove-Mailbox para:

  • Desconecte a caixa de correio da conta de usuário.
  • Mantenha a caixa de correio no estado desabilitado antes de ser excluída permanentemente, sujeita ao período de retenção de caixa de correio excluído (exceto se você usar os parâmetros Permanente ou StoreMailboxIdentity, que exclui imediatamente a caixa de correio do banco de dados).
  • Remova a conta de usuário.

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

Connect-Mailbox -Database "Mailbox Database" -Identity "John Evans"

Este exemplo conecta a caixa de correio desconectada de John Evans. O exemplo não especifica um usuário para conectar a caixa de correio, portanto, o comando tenta encontrar um objeto de usuário correspondente exclusivamente.

Exemplo 2

Connect-Mailbox -Identity "John Evans" -Database "MBXDB02" -LinkedDomainController FabrikamDC01 -LinkedMasterAccount john@fabrikam.com

Este exemplo conecta uma caixa de correio vinculada.

Exemplo 3

Connect-Mailbox -Identity "CAR001" -Database "MBXResourceDB" -Equipment -User "CAR001"

Este exemplo conecta uma caixa de correio de equipamento.

Exemplo 4

Connect-Mailbox -Identity "ConfRm212" -Database "MBXResourceDB" -Room -User "Conference Room 212"

Este exemplo conecta uma caixa de correio de sala.

Parâmetros

-ActiveSyncMailboxPolicy

O parâmetro ActiveSyncMailboxPolicy especifica a política de caixa de correio de dispositivo móvel aplicada à caixa de correio. Você pode usar qualquer valor que identifique a política com exclusividade. Por exemplo:.

  • Nome
  • DN (nome diferenciado)
  • GUID

Se você não usar esse parâmetro, a política de caixa de correio de dispositivo móvel será usada.

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

-AddressBookPolicy

O parâmetro AddressBookPolicy especifica a política de catálogo de endereços aplicada à caixa de correio. É possível usar qualquer valor que identifique exclusivamente a política de catálogo de endereços. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Para obter mais informações sobre políticas de catálogo de endereços, consulte Políticas de catálogo de endereços no Exchange Server.

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

-Alias

O parâmetro Alias especifica o alias do Exchange (também conhecido como apelido de email) para o destinatário. Esse valor identifica o destinatário como um objeto habilitado para email e não deve ser confundido com vários endereços de email para o mesmo destinatário (também conhecido como endereços de proxy). Um destinatário pode ter apenas um valor de Alias. O tamanho máximo é de 64 caracteres.

O valor do Alias pode conter letras, números e os seguintes caracteres:

  • !, #, %, *, +, -, /, =, ?, ^, _, e ~.
  • $, &, ', ', {, }e | precisam ser escapados (por exemplo -Alias what`'snew) ou todo o valor incluído em aspas individuais (por exemplo, -Alias 'what'snew'). O & caractere não tem suporte no valor do Alias para Azure AD Sincronização do Connect.
  • Os períodos (.) devem ser cercados por outros caracteres válidos (por exemplo, help.desk).
  • Caracteres unicode U+00A1 a U+00FF.

Quando você cria um destinatário sem especificar um endereço de email, o valor do Alias especificado é usado para gerar o endereço de email primário (alias@domain). Os caracteres Unicode com suporte são mapeados para os melhores caracteres de texto US-ASCII. Por exemplo, U+00F6 (ö) é alterado para oe no endereço de email primário.

Se você não usar o parâmetro Alias ao criar um destinatário, o valor de um parâmetro necessário diferente será usado para o valor da propriedade Alias:

  • Destinatários com contas de usuário (por exemplo, caixas de correio de usuário e usuários de email): o lado esquerdo do parâmetro MicrosoftOnlineServicesID ou UserPrincipalName é usado. Por exemplo, helpdesk@contoso.onmicrosoft.com resulta no valor helpdeskda propriedade Alias .
  • Destinatários sem contas de usuário (por exemplo, caixas de correio de sala, contatos de email e grupos de distribuição): o valor do parâmetro Name é usado. Os espaços são removidos e caracteres sem suporte são convertidos em pontos de interrogação (?).

Se você modificar o valor do Alias de um destinatário existente, o endereço de email primário será atualizado automaticamente somente em ambientes em que o destinatário está sujeito a políticas de endereço de email (a propriedade EmailAddressPolicyEnabled é True para o destinatário).

O parâmetro Alias nunca gera ou atualiza o endereço de email primário de um contato de email ou de um usuário de email.

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

-AllowLegacyDNMismatch

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

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

-Archive

A opção Arquivo especifica se deve conectar a caixa de correio de arquivo associada. Não é preciso especificar um valor com essa opção.

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

-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Database

O parâmetro Banco de Dados especifica o banco de dados exchange que contém a caixa de correio que você deseja conectar. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Use esse parâmetro com o parâmetro Identity para especificar a caixa de correio que deseja conectar.

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

-DomainController

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.

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

-Equipment

A opção Equipamento é necessária para conectar caixas de correio do equipamento. Não é preciso especificar um valor com essa opção.

As caixas de correio do equipamento são caixas de correio de recursos que não estão associadas a um local específico (por exemplo, veículos ou computadores).

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

-Force

A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.

Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.

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

-Identity

O parâmetro Identidade especifica a caixa de correio que você deseja conectar a uma conta de usuário. Esse parâmetro não especifica um objeto do Active Directory. Você pode usar os seguintes valores para identificar a caixa de correio:

  • Nome de exibição
  • GUID
  • LegacyExchangeDN

Use esse parâmetro com o parâmetro Banco de Dados para especificar a caixa de correio que deseja conectar.

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

-LinkedCredential

O parâmetro LinkedCredential especifica as credenciais usadas para acessar o controlador de domínio especificadas pelo parâmetro LinkedDomainController. Esse parâmetro é opcional, mesmo que você esteja conectando uma caixa de correio vinculada.

Um valor para esse parâmetro requer o cmdlet Get-Credential. Para pausar o comando e receber uma solicitação de credenciais, use o valor (Get-Credential). Ou, antes de executar esse comando, armazene as credenciais em uma variável (por exemplo, $cred = Get-Credential) e, em seguida, use o nome da variável ($cred) para esse parâmetro. Para saber mais, confira Obter credencial.

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

-LinkedDomainController

O parâmetro LinkedDomainController especifica o controlador de domínio da floresta em que a conta do usuário reside, se essa for uma caixa de correio vinculada. O controlador de domínio da floresta em que a conta do usuário reside é utilizado para fornecer informações de segurança sobre a conta especificada pelo parâmetro LinkedMasterAccount. Use o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que você deseja usar como valor para esse parâmetro.

Esse parâmetro só será necessário se você estiver conectando uma caixa de correio vinculada.

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

-LinkedMasterAccount

O parâmetro LinkedMasterAccount especifica a conta mestra na floresta em que reside a conta de usuário, se essa caixa de correio for uma caixa de correio vinculada. A conta principal é a conta de caixa de correio está vinculada. A conta principal concede acesso à caixa de correio. Esse parâmetro só será obrigatório se uma caixa de correio vinculada estiver sendo criada. Você pode usar qualquer valor que identifica exclusivamente a conta principal. Por exemplo: Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • Nome diferenciado (DN)
  • GUID

Esse parâmetro só será necessário se você estiver conectando uma caixa de correio vinculada.

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

-ManagedFolderMailboxPolicy

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

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

-ManagedFolderMailboxPolicyAllowed

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

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

-RetentionPolicy

O parâmetro RetentionPolicy especifica a política de retenção aplicada à caixa de correio. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

As diretivas de retenção consistem em marcas aplicadas a pastas da caixa de correio e itens de email para determinar o período de tempo durante o qual os itens devem ser retidos.

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

-Room

A opção Sala é necessária para conectar caixas de correio da sala. Não é preciso especificar um valor com essa opção.

As caixas de correio de sala são caixas de correio de recursos associadas a um local específico (por exemplo, salas de conferência).

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

-Shared

A opção Compartilhada é necessária para conectar caixas de correio compartilhadas. Não é preciso especificar um valor com essa opção.

Uma caixa de correio compartilhada é uma caixa de correio onde vários usuários podem fazer logon para acessar o conteúdo da caixa de correio. Essa caixa de correio não está associada a nenhum dos usuários que podem fazer logon. Está associada a uma conta de usuário desabilitada.

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

-User

O parâmetro User especifica o objeto de usuário no Active Directory ao qual você deseja conectar a caixa de correio. É possível usar qualquer valor que identifique o usuário com exclusividade. Por exemplo: Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • Nome diferenciado (DN)
  • GUID

Se você não usar esse parâmetro, o comando usará os valores de propriedade LegacyExchangeDN e DisplayName da caixa de correio para encontrar uma conta de usuário que tenha esses mesmos valores. Se ele não conseguir encontrar uma correspondência exclusiva, ele não conectará a caixa de correio.

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

-ValidateOnly

A opção ValidateOnly solicita ao cmdlet a avaliação das condições e dos requisitos necessários à execução da operação e informa se haverá êxito ou falha na operação. Não é preciso especificar um valor com essa opção.

Nenhuma alteração é feita quando você usa essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, 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 2010, 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.