.png)
New-RemoteMailbox
Aplica-se a: Exchange Server 2013
Tópico modificado em: 2012-07-23
Use o cmdlet New-RemoteMailbox para criar um usuário habilitado para email no Active Directory local e também cria uma caixa de correio associada no serviço baseado em nuvem.
Para obter informações sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Sintaxe.
New-RemoteMailbox -Room <SwitchParameter> [-Password <SecureString>] [-UserPrincipalName <String>] <COMMON PARAMETERS>
New-RemoteMailbox -Equipment <SwitchParameter> [-Password <SecureString>] [-UserPrincipalName <String>] <COMMON PARAMETERS>
New-RemoteMailbox -AccountDisabled <SwitchParameter> [-Password <SecureString>] [-UserPrincipalName <String>] <COMMON PARAMETERS>
New-RemoteMailbox [-Password <SecureString>] [-UserPrincipalName <String>] <COMMON PARAMETERS>
New-RemoteMailbox -Password <SecureString> -UserPrincipalName <String> <COMMON PARAMETERS>
COMMON PARAMETERS: -Name <String> [-Alias <String>] [-ArbitrationMailbox <MailboxIdParameter>] [-Archive <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-ImmutableId <String>] [-Initials <String>] [-LastName <String>] [-ModeratedBy <MultiValuedProperty>] [-ModerationEnabled <$true | $false>] [-OnPremisesOrganizationalUnit <OrganizationalUnitIdParameter>] [-OverrideRecipientQuotas <SwitchParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-RemotePowerShellEnabled <$true | $false>] [-RemoteRoutingAddress <ProxyAddress>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SendModerationNotifications <Never | Internal | Always>] [-WhatIf [<SwitchParameter>]]
Este exemplo cria um usuário habilitado para email local existente e sua uma caixa de correio associada no serviço. O endereço de encaminhamento remoto não tem que ser especificado porque o fluxo de correio entre a organização local e o serviço foi configurado. Usando esta configuração, o cmdlet New-RemoteMailbox calcula automaticamente o endereço de SMTP da caixa de correio a ser usada com o parâmetro RemoteRoutingAddress. Este exemplo também assume que a sincronização de diretório foi configurada.
Primeiro, armazene a senha para usar com a nova caixa de correio remota em uma variável usando o cmdlet Get-Credential.
$Credentials = Get-Credential
Em seguida, execute o cmdlet New-RemoteMailbox para criar o usuário de email.
New-RemoteMailbox -Name "Kim Akers" -Password $Credentials.Password -UserPrincipalName kim@contoso.com
Depois que o novo usuário é criado, a sincronização do diretório sincroniza o usuário habilitado para email ao serviço e a caixa de correio associada é criada.
Este exemplo mostra como fazer isso:
-
Cria um usuário habilitado para email local. O usuário habilitado para email é colocado em contoso.com/Archive Users OU. A unidade Organizacional não terá efeito na caixa de correio do serviço.
-
Cria a caixa de correio associada no serviço.
-
Cria uma caixa de correio de arquivamento no serviço para a caixa de correio.
Como no Exemplo 1, este exemplo assume que o fluxo de correio e a sincronização do diretório foram propriamente configurados.
Primeiro, armazene a senha para usar com a nova caixa de correio remota em uma variável usando o cmdlet Get-Credential.
$Credentials = Get-Credential
Em seguida, execute o cmdlet New-RemoteMailbox para criar o usuário de email.
New-RemoteMailbox -Name "Kim Akers" -Password $Credentials.Password -UserPrincipalName kim@contoso.com -OnPremisesOrganizationalUnit "contoso.com/Archive Users" -Archive
O cmdlet New-RemoteMailbox cria um usuário habilitado para email local. O usuário habilitado para email contém um atributo específico, que indica que uma caixa de correio associada no serviço pode ser criada quando o usuário está sincronizado para o serviço usando a sincronização de diretório.
A sincronização de diretório deve ser configurada corretamente para uma caixa de correio a ser criada no serviço. A criação da caixa de correio de serviço não é imediata e depende do horário de sincronização do diretório.
 Importante: |
|---|
| A diretiva que você aplica a destinatários na organização do Exchange local, como Unificação de Mensagens ou diretivas de de conformidade, não são aplicadas as caixas de correio no serviço. Você deve configurar a diretiva no serviço se você quiser que a diretiva seja aplicada a destinatários no serviço. |
Para executar esse cmdlet, você precisa ter permissões. Embora todos os parâmetros para este cmdlet estejam listados neste tópico, talvez você não tenha acesso a alguns parâmetros, caso eles não estejam incluídos nas permissões atribuídas a você. Para ver de que permissões você precisa, consulte o Entrada "Caixas de Correio Remotas" no tópico Permissões de Destinatários.
| Parâmetro | Obrigatório | Digite | Descrição | ||
|---|---|---|---|---|---|
| AccountDisabled | Necessário | System.Management.Automation.SwitchParameter | A opção AccountDisabled especifica se é necessário criar o usuário habilitado para email no estado desabilitado. Não é necessário especificar um valor com esse parâmetro. | ||
| Equipment | Necessário | System.Management.Automation.SwitchParameter | A opção Equipment especifica que a caixa de correio no serviço deve ser criada como uma caixa de correio de equipamento. Não é possível usar a opção Equipmentse você especificou a opção Room. | ||
| Name | Necessário | System.String | O parâmetro Name especifica o nome comum (CN) do usuário habilitado para email local e sua caixa de correio associada no serviço. | ||
| Password | Necessário | System.Security.SecureString | O parâmetro Password especifica a senha usada pelo usuário de email para proteger a sua conta e caixa de correio associada no serviço. | ||
| Room | Necessário | System.Management.Automation.SwitchParameter | A opção Room especifica que a caixa de correio no serviço deve ser criada como uma caixa de correio de sala. Não é possível usar a opção Roomse você especificou a opção Equipment. | ||
| UserPrincipalName | Necessário | System.String | O parâmetro UserPrincipalName define o nome de um usuário do sistema em um formato de endereço de email (por exemplo, ed@contoso.com). | ||
| Alias | Opcional | System.String | O parâmetro Alias especifica o alias de email do usuário e a sua caixa de correio associada no serviço que você está criando. O alias pode ser uma combinação de caracteres separados por um ponto sem espaços. Não use caracteres especiais no alias. | ||
| ArbitrationMailbox | Opcional | Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter | O parâmetro ArbitrationMailbox especifica a caixa de correio usada para gerenciar o processo de moderação. | ||
| Archive | Opcional | System.Management.Automation.SwitchParameter | A opção do Archive especifica se é necessário criar uma caixa de correio de arquivo no serviço além da caixa de correio criada no serviço. Não é necessário especificar um valor com esta opção. | ||
| Confirm | Opcional | System.Management.Automation.SwitchParameter | A opção Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Não é preciso especificar um valor com a opção Confirm. | ||
| DisplayName | Opcional | System.String | O parâmetro DisplayName especifica o nome exibido no Microsoft Outlook para o usuário de email e a sua caixa de correio associada no serviço. | ||
| DomainController | Opcional | Microsoft.Exchange.Data.Fqdn | O parâmetro DomainController especifica o FQDN do controlador de domínio que grava essa alteração de configuração no Active Directory. | ||
| FirstName | Opcional | System.String | O parâmetro FirstName especifica o nome do usuário criado. | ||
| ImmutableId | Opcional | System.String | O parâmetro ImmutableId é usado pela Sincronização da GAL (GALSync) e especifica um identificador único e imutável na forma de um endereço SMTP para uma caixa de correio do Exchange que é usada para delegação federada ao requisitar tokens SAML. Se a federação estiver configurada para esta caixa de correio e este parâmetro não for definido ao se criar a caixa de correio, o Exchange criará o valor para o identificador imutável com base no ExchangeGUID da caixa de correio e no namespace da conta federada, por exemplo, 7a78e7c8-620e-4d85-99d3-c90d90f29699@mail.contoso.com. O parâmetro ImmutableId deve ser definido se os Serviços de Federação do Active Directory (AD FS) estiverem implantados para permitir logon único em uma caixa de correio externa e o AD FS estiver configurado para usar um atributo diferente de ExchangeGUID para solicitações de token de entrada. Ambos, Exchange e AD FS devem solicitar o mesmo token para o mesmo usuário para garantir a funcionalidade adequada para um cenário de implantação do Exchange entre locais. | ||
| Initials | Opcional | System.String | O parâmetro Initials especifica as iniciais do usuário criado. | ||
| LastName | Opcional | System.String | O parâmetro LastName especifica o sobrenome do usuário criado. | ||
| ModeratedBy | Opcional | Microsoft.Exchange.Data.MultiValuedProperty | O parâmetro ModeratedBy especifica os usuários responsáveis por moderar as mensagens enviadas para esse usuário de email e a sua caixa de correio associada no serviço. Para designar mais de um usuário, separe-os por vírgulas. Esse parâmetro é obrigatório se o parâmetro ModerationEnabled for definido como | ||
| ModerationEnabled | Opcional | System.Boolean | O parâmetro ModerationEnabled especifica se é necessário habilitar ou desabilitar a moderação do usuário de email. Os dois valores possíveis para esse parâmetro são O valor padrão é | ||
| OnPremisesOrganizationalUnit | Opcional | Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter | O parâmetro OnPremisesOrganizationalUnit especifica a OU (unidade organizacional) na organização local na qual a nova caixa de correio é adicionada (por exemplo, redmond.contoso.com/Users). Este parâmetro não tem efeito sobre a caixa de correio do serviço. | ||
| OverrideRecipientQuotas | Opcional | System.Management.Automation.SwitchParameter | Esse parâmetro está reservado para uso interno da Microsoft. | ||
| PrimarySmtpAddress | Opcional | Microsoft.Exchange.Data.SmtpAddress | O parâmetro PrimarySmtpAddress especifica o endereço SMTP principal para o usuário de email. Por padrão, o endereço SMTP principal é gerado com base na diretiva de endereço de email padrão. Se especificar um endereço SMTP principal usando esse parâmetro, o comando configura o atributo EmailAddressPolicyEnabled do usuário de email em | ||
| RemotePowerShellEnabled | Opcional | System.Boolean | O parâmetro RemotePowerShellEnabled especifica se o usuário pode usar o Windows PowerShell remoto. O Windows PowerShell remoto é necessário para abrir o Shell de Gerenciamento do Exchange em servidores de Caixa de Correio e Acesso para Cliente. O acesso ao Windows PowerShell remoto é obrigatório mesmo se você tentar abrir o Shell no servidor local. Os valores válidos são | ||
| RemoteRoutingAddress | Opcional | Microsoft.Exchange.Data.ProxyAddress | O parâmetro RemoteRoutingAddress especifica o endereço de SMTP da caixa de correio no serviço que este usuário está associado. Se você tiver configurado o fluxo de correio entre a organização local e o serviço, você não precisa especificar este parâmetro. O endereço de roteamento remoto é calculado automaticamente. | ||
| ResetPasswordOnNextLogon | Opcional | System.Boolean | O parâmetro ResetPasswordOnNextLogon especifica se a senha no parâmetro Password deve ser redefinida da próxima vez em que o usuário fizer logon. Se definido como | ||
| SamAccountName | Opcional | System.String | O parâmetro SamAccountName define o nome de logon usado para suporte a clientes e servidores que estejam executando versões antigas do sistema operacional. Esse atributo deve ter menos de 20 caracteres. Um nome de conta pode conter letras, números e os seguintes sinais de pontuação e símbolos:
| ||
| SendModerationNotifications | Opcional | Microsoft.Exchange.Data.Directory.Recipient.TransportModerationNotificationFlags | O parâmetro SendModerationNotifications especifica se notificações de status são enviadas para usuários ao enviarem uma mensagem para o grupo de distribuição moderado. Especifique um dos valores a seguir:
Defina esse parâmetro como Defina este parâmetro como Defina esse parâmetro como O valor padrão é
| ||
| WhatIf | Opcional | System.Management.Automation.SwitchParameter | A opção WhatIf instrui o comando a simular as ações que ele executaria no objeto. Ao usar a opção WhatIf, você poderá exibir quais alterações ocorrerão, sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com a opção WhatIf. |
Para ver os tipos de entrada que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlets. Se o campo Tipo de Entrada de um cmdlet estiver em branco, é porque o cmdlet não aceita dados de entrada.
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 cmdlets. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.
