Connect-Mailbox

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

Use o cmdlet Connect-Mailbox para conectar caixas de correio desconectadas às contas de usuário existentes que ainda não possuem caixas de correio.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/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>
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-LinkedCredential <PSCredential>]
       [-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>
       [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
       [-AllowLegacyDNMismatch]
       [-Archive]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-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 User para especificar a conta de usuário, verifique se especificou a conta correta. Se você não usar o parâmetro User, recomendamos que você use a opção ValidateOnly para verificar a conta de usuário à qual 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 caixas de correio de 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ída.

  • Mantenha a conta de 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ída (exceto se você usar os parâmetros permanentes 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.

Examples

Exemplo 1

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

Este exemplo conecta a caixa de correio desconectada John Evans. O exemplo não especifica um usuário para conectar a caixa de correio, portanto, o comando tenta localizar 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.

Parameters

-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
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 do catálogo de endereços, consulte políticas de catálogo de endereços no Exchange Server.

Type:AddressBookMailboxPolicyIdParameter
Position:Named
Default value:None
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 do 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 valor de alias pode conter letras, números e os caracteres!, #, $,%, &, ', * , +,-,/, =,?, ^, _ ,, ` {, |,} e ~. Os pontos (.) são permitidos, mas cada período deve estar entre outros caracteres válidos (por exemplo, help. Desk). Caracteres Unicode de U+00A1 a U+00FF também são permitidos. O comprimento máximo do valor Alias é 64 caracteres.

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 principal ( <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 principal.

Se você não usar o parâmetro Alias ao criar um destinatário, o valor de um parâmetro obrigató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.com resulta no valor da propriedade alias Help Desk.

  • 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 os caracteres não suportados 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 principal é atualizado automaticamente somente em ambientes em que o destinatário está sujeito às 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 principal de um contato de email ou um usuário de email.

Type:String
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Archive

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

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

O comutador compartilhado é necessário 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. Esta 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
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, Remover-* cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação 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 confirmar o comando antes de continuar.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
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 Database especifica o banco de dados do 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

Você usa esse parâmetro com o parâmetro Identity para especificar a caixa de correio que você deseja conectar.

Type:DatabaseIdParameter
Position:2
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Equipamento

O comutador de equipamento é necessário para conectar caixas de correio de equipamento. Não é preciso especificar um valor com essa opção.

Caixas de correio de 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Força

A opção Force especifica se é preciso suprimir mensagens de aviso ou confirmação. Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
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 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 para exibição

  • GUID

  • LegacyExchangeDN

Você usa esse parâmetro com o parâmetro Database para especificar a caixa de correio que você deseja conectar.

Type:StoreMailboxIdParameter
Position:1
Default value:None
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
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 será necessário somente se você estiver conectando uma caixa de correio vinculada.

Type:Fqdn
Position:Named
Default value:None
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 principal na floresta em que a conta de usuário reside, 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:

  • Nome

  • DN (nome diferenciado)

  • Nome diferenciado (DN)

  • GUID

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

Type:UserIdParameter
Position:Named
Default value:None
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Sala

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

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

Type:SwitchParameter
Position:Named
Default value:None
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:

  • 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 localizar uma conta de usuário que tenha esses mesmos valores. Se não for possível localizar uma correspondência exclusiva, ela não conectará a caixa de correio.

Type:UserIdParameter
Position:Named
Default value:None
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 é possível fazer nenhuma alteração ao usar a opção ValidateOnly.

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

Inputs

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.

Outputs

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.