Set-User

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Set-User para modificar atributos de usuário. Você pode usar esse cmdlet para modificar todos os objetos que têm contas de usuário (por exemplo, caixas de correio de usuário, usuários de email e contas de usuário).

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

Syntax

Set-User
   [-Identity] <UserIdParameter>
   [-AllowUMCallsFromNonUsers <AllowUMCallsFromNonUsersFlags>]
   [-Arbitration]
   [-AssistantName <String>]
   [-AuthenticationPolicy <String>]
   [-BlockCloudCache <Boolean>]
   [-CanHaveCloudCache <Boolean>]
   [-CertificateSubject <MultiValuedProperty>]
   [-City <String>]
   [-ClearDataEncryptionPolicy]
   [-Company <String>]
   [-Confirm]
   [-CountryOrRegion <CountryInfo>]
   [-CreateDTMFMap <Boolean>]
   [-Department <String>]
   [-DesiredWorkloads <MailboxWorkloadFlags>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-Fax <String>]
   [-FirstName <String>]
   [-Force]
   [-GeoCoordinates <GeoCoordinates>]
   [-HomePhone <String>]
   [-IgnoreDefaultScope]
   [-Initials <String>]
   [-LastName <String>]
   [-LinkedCredential <PSCredential>]
   [-LinkedDomainController <String>]
   [-LinkedMasterAccount <UserIdParameter>]
   [-MailboxRegion <String>]
   [-MailboxRegionSuffix <MailboxRegionSuffixValue>]
   [-Manager <UserContactIdParameter>]
   [-MobilePhone <String>]
   [-Name <String>]
   [-Notes <String>]
   [-Office <String>]
   [-OtherFax <MultiValuedProperty>]
   [-OtherHomePhone <MultiValuedProperty>]
   [-OtherTelephone <MultiValuedProperty>]
   [-Pager <String>]
   [-PermanentlyClearPreviousMailboxInfo]
   [-Phone <String>]
   [-PhoneticDisplayName <String>]
   [-PostalCode <String>]
   [-PostOfficeBox <MultiValuedProperty>]
   [-PublicFolder]
   [-RemotePowerShellEnabled <Boolean>]
   [-RemoveMailboxProvisioningConstraint]
   [-ResetPasswordOnNextLogon <Boolean>]
   [-SamAccountName <String>]
   [-SeniorityIndex <Int32>]
   [-SimpleDisplayName <String>]
   [-SkipDualWrite]
   [-StateOrProvince <String>]
   [-StreetAddress <String>]
   [-StsRefreshTokensValidFrom <DateTime>]
   [-TelephoneAssistant <String>]
   [-Title <String>]
   [-UMCallingLineIds <MultiValuedProperty>]
   [-UMDtmfMap <MultiValuedProperty>]
   [-UserPrincipalName <String>]
   [-VIP <Boolean>]
   [-WebPage <String>]
   [-WhatIf]
   [-WindowsEmailAddress <SmtpAddress>]
   [<CommonParameters>]

Description

O cmdlet Set-User não contém propriedades relacionadas ao email para caixas de correio ou usuários de email. Para modificar as propriedades relacionadas ao email de um usuário, você precisa usar o cmdlet correspondente com base no tipo de objeto (por exemplo, Set-Mailbox ou Set-MailUser).

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

Set-User -Identity Contoso\Jill -DisplayName "Jill Frank"

Este exemplo define o nome para exibição do usuário Jill Frank.

Exemplo 2

Set-User -Identity Kweku@fabrikam.com -LinkedMasterAccount $null

Este exemplo desvincula a caixa de correio Kweku@fabrikam.com vinculada e a converte em uma caixa de correio do usuário definindo o parâmetro LinkedMasterAccount como $null.

Executar esse procedimento em uma caixa de correio vinculada remove todas as permissões na caixa de correio, como Enviar Como, Acesso Completo, pasta e delegação de calendário.

Parâmetros

-AllowUMCallsFromNonUsers

Este parâmetro está disponível somente no Exchange local.

O parâmetro AllowUMCallsFromNonUsers especifica se o usuário deve excluir as pesquisas de diretório de Mensagens Unificadas.

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

-Arbitration

Este parâmetro está disponível somente no Exchange local.

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

As caixas de correio de arbitragem são caixas de correio do sistema usadas para armazenar diferentes tipos de dados do sistema e para gerenciar o fluxo de trabalho de aprovação de mensagens.

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

-AssistantName

O parâmetro AssistantName especifica o nome do assistente do usuário.

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, Exchange Online, Exchange Online Protection

-AuthenticationPolicy

O parâmetro AuthenticationPolicy especifica a política de autenticação a ser aplicada ao usuário. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Para remover a atribuição de política para o usuário, use o valor $null.

Você cria políticas de autenticação com o cmdlet New-AuthenticationPolicy para bloquear ou permitir seletivamente a autenticação básica ou (no Exchange 2019 CU2 ou posterior) outros métodos de autenticação herdado.

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

-BlockCloudCache

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Preencher BlockCloudCache Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-CanHaveCloudCache

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Preencher CanHaveCloudCache Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-CertificateSubject

Este parâmetro está disponível somente no Exchange local.

O parâmetro CertificateSubject especifica o valor do campo de assunto do certificado digital do usuário.

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

-City

O parâmetro City especifica a cidade do usuário.

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, Exchange Online, Exchange Online Protection

-ClearDataEncryptionPolicy

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Preencher ClearDataEncryptionPolicy Description }}

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Company

O parâmetro Company especifica a empresa do usuário.

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, Exchange Online, Exchange Online Protection

-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, Exchange Online, Exchange Online Protection

-CountryOrRegion

O parâmetro CountryOrRegion especifica o país ou a região do usuário. Um valor válido é um código de país de duas letras ISO 3166-1 válido (por exemplo, AU para Austrália) ou o nome amigável correspondente para o país (que pode ser diferente do nome curto oficial da Agência de Manutenção iso 3166).

Uma referência para códigos de país de duas letras está disponível na Lista de Códigos de País.

O nome amigável é retornado no valor da propriedade CountryOrRegion pelo cmdlet Get-User, mas você pode usar o nome amigável ou o código de país de duas letras em operações de filtro.

Type:CountryInfo
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, Exchange Online, Exchange Online Protection

-CreateDTMFMap

Este parâmetro está disponível somente no Exchange local.

O parâmetro CreateDTMFMap especifica se é necessário criar um mapa DTMF (dupla frequência múltipla) para o destinatário. Isso permite que o destinatário seja identificado usando um teclado telefônico em ambientes de UM (Mensagens Unificadas). Os valores válidos são:

  • $true: um mapa DTMF é criado para o destinatário. Esse é o valor padrão.
  • $true: um mapa DTMF foi criado para o destinatário. Este é o valor padrão.
Type:Boolean
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

-Department

O parâmetro Department especifica o departamento do usuário.

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, Exchange Online, Exchange Online Protection

-DesiredWorkloads

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Preencher Descrição desiredWorkloads }}

Type:Microsoft.Exchange.Data.MailboxWorkloadFlags
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-DisplayName

O parâmetro DisplayName especifica o nome para exibição do usuário. O nome de exibição está visível no centro de administração do Exchange e no Active Directory. O comprimento máximo é de 256 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

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, Exchange Online, Exchange Online Protection

-DomainController

Este parâmetro está disponível somente no Exchange local.

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

-Fax

O parâmetro Fax especifica o número de fax do usuário.

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, Exchange Online, Exchange Online Protection

-FirstName

O parâmetro FirstName especifica o nome do usuário.

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, Exchange Online, Exchange Online Protection

-Force

Esse parâmetro só está disponível no serviço baseado em nuvem.

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 Online, Exchange Online Protection

-GeoCoordinates

O parâmetro GeoCoordinates especifica o local do usuário em coordenadas de latitude, longitude e (opcionalmente) altitude. Um valor válido para este parâmetro usa um dos seguintes formatos:

  • Latitude e longitude: por exemplo, "47.644125;-122.122411"
  • Latitude, longitude e altitude: por exemplo, "47.644125;-122.122411;161.432"

Observação: se os separadores de período não funcionarem para você, use vírgulas.

Type:GeoCoordinates
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, Exchange Online, Exchange Online Protection

-HomePhone

O parâmetro HomePhone especifica o número de telefone residencial do usuário.

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, Exchange Online, Exchange Online Protection

-Identity

O parâmetro Identity especifica o usuário que você deseja modificar. É possível usar qualquer valor que identifique o usuário com exclusividade. Por exemplo:

  • Nome
  • Nome principal do usuário (UPN)
  • DN (nome diferenciado)
  • Nome diferenciado (DN)
  • GUID
  • UserPrincipalName
Type:UserIdParameter
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, Exchange Online, Exchange Online Protection

-IgnoreDefaultScope

Este parâmetro está disponível somente no Exchange local.

A opção IgnoreDefaultScope informa ao comando para ignorar a configuração de escopo padrão do destinatário para a sessão do Exchange PowerShell e usar toda a floresta como o escopo. Não é preciso especificar um valor com essa opção.

Essa opção permite que o comando acesse objetos do Active Directory que não estão disponíveis no momento no escopo padrão, mas também introduz as seguintes restrições:

  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
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

-Initials

O parâmetro Initials especifica as iniciais do segundo nome do usuário.

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, Exchange Online, Exchange Online Protection

-LastName

O parâmetro LastName especifica o sobrenome do usuário.

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, Exchange Online, Exchange Online Protection

-LinkedCredential

Este parâmetro está disponível somente no Exchange local.

O parâmetro LinkedCredential especifica o nome de usuário e a senha usados para acessar o controlador de domínio especificado pelo parâmetro LinkedDomainController.

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.

O parâmetro LinkedCredential só pode ser usado com um usuário vinculado.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro LinkedDomainController especifica o controlador de domínio da floresta em que a conta do usuário reside, se este for um usuário vinculado. 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.

Este parâmetro é necessário somente se um usuário vinculado estiver sendo conectado.

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

-LinkedMasterAccount

Este parâmetro está disponível somente no Exchange local.

O parâmetro LinkedMasterAccount especifica a conta principal da floresta em que a conta do usuário reside, se este for um usuário vinculado. A conta principal é a conta à qual o usuário está vinculado. A conta principal concede acesso ao usuário. Utilize um dos seguintes valores:

  • GUID
  • DN
  • Domain\Account
  • UPN
  • LegacyExchangeDN
  • SmtpAddress
  • Alias
  • $null

Caso defina o valor do parâmetro como $null, você vai desvincular a conta e converter a caixa de correio vinculada em uma caixa de correio de usuário não-vinculada. A caixa de correio não irá manter as permissões configuradas anteriormente nela, como Enviar como, acesso total e delegação de calendário.

Este parâmetro é necessário somente se um usuário vinculado estiver sendo conectado.

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

-MailboxRegion

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Preencher Descrição da Região de Caixa de Correio }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-MailboxRegionSuffix

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Fill MailboxRegionSuffix Description }}

Type:MailboxRegionSuffixValue
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Manager

O parâmetro Manager especifica o gerente do usuário.

Type:UserContactIdParameter
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, Exchange Online, Exchange Online Protection

-MobilePhone

O parâmetro MobilePhone especifica o número do telefone celular principal do usuário.

Observação: no Exchange Online, você não pode usar esse parâmetro. Em vez disso, use o parâmetro MobilePhone no cmdlet Update-MgUser no Microsoft Graph PowerShell.

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, Exchange Online, Exchange Online Protection

-Name

O parâmetro Nome especifica o nome exclusivo do usuário. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

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, Exchange Online, Exchange Online Protection

-Notes

Os parâmetros Notes especificam informações adicionais sobre o objeto. Se o valor contiver espaços, coloque-o entre aspas (").

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, Exchange Online, Exchange Online Protection

-Office

O parâmetro Office especifica o nome ou o número do escritório físico do usuário.

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, Exchange Online, Exchange Online Protection

-OtherFax

O parâmetro OtherFax especifica o número de fax alternativo do usuário.

Type:MultiValuedProperty
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, Exchange Online, Exchange Online Protection

-OtherHomePhone

O parâmetro OtherHomePhone especifica o número de telefone residencial alternativo do usuário.

Type:MultiValuedProperty
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, Exchange Online, Exchange Online Protection

-OtherTelephone

O parâmetro OtherTelephone especifica o número do telefone alternativo do usuário.

Type:MultiValuedProperty
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, Exchange Online, Exchange Online Protection

-Pager

O parâmetro Pager especifica o número de pager do usuário.

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, Exchange Online, Exchange Online Protection

-PermanentlyClearPreviousMailboxInfo

Esse parâmetro não está disponível ou funcional no Exchange local. Ele só está disponível em Exchange Online.

A opção PermanentlyClearPreviousMailboxInfo especifica se deve limpar os atributos da caixa de correio Exchange Online em um usuário. Não é preciso especificar um valor com essa opção.

Limpar esses atributos pode ser necessário em cenários de movimentação e licenciamento de caixa de correio entre o Exchange local e o Microsoft 365. Para obter mais informações, consulte Limpar permanentemente as informações da caixa de correio anterior.

Cuidado: essa opção exclui permanentemente a caixa de correio de nuvem existente e seu arquivo associado, impede que você se reconecte à caixa de correio e impede que você recupere conteúdo da caixa de correio.

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

-Phone

O parâmetro Phone especifica o número do telefone comercial do usuário.

Observação: no Exchange Online, você não pode usar esse parâmetro. Em vez disso, use o parâmetro BusinessPhones no cmdlet Update-MgUser no Microsoft Graph PowerShell.

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, Exchange Online, Exchange Online Protection

-PhoneticDisplayName

O parâmetro PhoneticDisplayName especifica uma ortografia alternativa do nome do usuário que é usada para texto em fala nos ambientes UM (Unificação de Mensagens). Normalmente, você usa esse parâmetro quando a pronúncia e a ortografia do nome do usuário não correspondem. O comprimento máximo é de 256 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

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, Exchange Online, Exchange Online Protection

-PostalCode

O parâmetro PostalCode especifica o CEP ou código postal do usuário.

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, Exchange Online, Exchange Online Protection

-PostOfficeBox

O parâmetro PostOfficeBox especifica o número do CEP do usuário.

Type:MultiValuedProperty
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, Exchange Online, Exchange Online Protection

-PublicFolder

A opção PublicFolder é necessária para modificar caixas de correio de pasta pública. Não é preciso especificar um valor com essa opção.

As caixas de correio de pasta pública são caixas de correio desenvolvidas especialmente para armazenar a hierarquia e o conteúdo das pastas públicas.

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, Exchange Online, Exchange Online Protection

-RemotePowerShellEnabled

O parâmetro RemotePowerShellEnabled especifica se o usuário tem acesso ao PowerShell remoto. O acesso remoto do PowerShell é necessário para abrir o Shell de Gerenciamento do Exchange ou o Centro de Administração do Exchange (EAC), mesmo que você esteja tentando abrir o Shell de Gerenciamento do Exchange ou o EAC no servidor de caixa de correio local. Os valores válidos são:

  • $true: o usuário tem acesso ao PowerShell remoto.
  • $false: o usuário não tem acesso ao PowerShell remoto.

O valor padrão depende das funções de gerenciamento atribuídas ao usuário.

Type:Boolean
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, Exchange Online, Exchange Online Protection

-RemoveMailboxProvisioningConstraint

Esse parâmetro só está disponível no serviço baseado em nuvem.

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 Online, Exchange Online Protection

-ResetPasswordOnNextLogon

O parâmetro ResetPasswordOnNextLogon especifica se o usuário deve alterar sua senha na próxima vez que fizer logon. Os valores válidos são:

  • $true: o usuário deve alterar sua senha na próxima vez que fizer logon.
  • $false: o usuário não é obrigado a alterar sua senha na próxima vez que fizer logon. Esse é o valor padrão.
Type:Boolean
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, Exchange Online, Exchange Online Protection

-SamAccountName

Este parâmetro está disponível somente no Exchange local.

O parâmetro SamAccountName (também conhecido como conta de usuário ou nome de grupo pré-Windows 2000) especifica um identificador de objeto compatível com versões mais antigas dos sistemas operacionais cliente e servidor do Microsoft Windows. O valor pode conter letras, números, espaços, períodos (.) e os seguintes caracteres: !, #, $, %, ^, , &-, _, {, }e ~. O último caractere não pode ser um período. Caracteres unicode são permitidos, mas caracteres acentuados podem gerar colisões (por exemplo, o e ö match). O comprimento máximo é de 20 caracteres.

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

-SeniorityIndex

O parâmetro SeniorityIndex especifica a ordem em que este usuário será exibido em um catálogo de endereços hierárquico. Um usuário com o valor 2 aparecerá mais alto em um catálogo de endereços do que um usuário com o valor 1.

Type:Int32
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, Exchange Online, Exchange Online Protection

-SimpleDisplayName

O parâmetro SimpleDisplayName é usado para exibir uma descrição alternativa do objeto quando apenas um conjunto limitado de caracteres é permitido. Os caracteres válidos são:

  • O parâmetro SimpleDisplayName é usado para exibir uma descrição alternativa do objeto, quando apenas um conjunto limitado de caracteres for permitido. Os caracteres válidos são:
  • a – z
  • A – Z
  • espaço
  • " ' ( ) + , - . / : ?
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, Exchange Online, Exchange Online Protection

-SkipDualWrite

Este parâmetro está disponível somente no Exchange local.

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

-StateOrProvince

O parâmetro StateOrProvince especifica o estado ou província do usuário.

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, Exchange Online, Exchange Online Protection

-StreetAddress

O parâmetro StreetAddress especifica o endereço físico do usuário.

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, Exchange Online, Exchange Online Protection

-StsRefreshTokensValidFrom

Esse parâmetro só está disponível no serviço baseado em nuvem.

O StsRefreshTokensValidFrom especifica a data-hora da qual os tokens de atualização STS do usuário são válidos.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-TelephoneAssistant

Este parâmetro está disponível somente no Exchange local.

O parâmetro TelephoneAssistant especifica o número de telefone do assistente do usuário.

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

-Title

O parâmetro Title especifica o cargo do usuário.

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, Exchange Online, Exchange Online Protection

-UMCallingLineIds

Este parâmetro está disponível somente no Exchange local.

O parâmetro UMCallingLineIds especifica números de telefone ou ramais que podem ser mapeados para um usuário habilitado para Unificação de Mensagens (UM). É possível especificar mais de um número de telefone para cada usuário, separados por vírgula. Este parâmetro aceita dígitos com menos de 128 caracteres e pode incluir um sinal de mais (+) opcional precedendo os números. Cada usuário habilitado para UM deve ter um valor do parâmetro UMCallingLineIds exclusivo.

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

-UMDtmfMap

Este parâmetro está disponível somente no Exchange local.

O parâmetro UMDtmfMap especifica os valores de mapa DTMF (dupla frequência múltipla) para o destinatário. Isso permite que o destinatário seja identificado usando um teclado telefônico em ambientes de UM (Mensagens Unificadas). Normalmente, esses valores DTMF são criados e atualizados automaticamente, mas você pode usar esse parâmetro para fazer alterações manualmente. Esse parâmetro aceita a seguinte sintaxe:

  • emailAddress:<integers>
  • lastNameFirstName:<integers>
  • firstNameLastName:<integers>

Para inserir valores que substituem todas as entradas existentes, use a seguinte sintaxe: emailAddress:<integers>,lastNameFirstName:<integers>,firstNameLastName:<integers>.

Se você usar essa sintaxe e omitir qualquer um dos valores de mapa DTMF, esses valores serão removidos do destinatário. Por exemplo, se você especificar apenas emailAddress:<integers>, todos os valores existentes lastNameFirstName e firstNameLastName serão removidos.

Para adicionar ou remover valores sem afetar outras entradas existentes, use a seguinte sintaxe: @{Add="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"; Remove="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"}.

Se você usar essa sintaxe, não precisará especificar todos os valores do mapa DTMF e especificar vários valores de mapa DTMF. Por exemplo, você pode usar @{Add="emailAddress:<integers1>","emailAddress:<integers2>} para adicionar dois novos valores para emailAddress sem afetar os valores lastNameFirstName e firstNameLastName existentes.

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

-UserPrincipalName

Este parâmetro está disponível somente no Exchange local.

O parâmetro UserPrincipalName especifica o nome de logon da conta do usuário. O UPN usa um formato de endereço de email: username@domain. Normalmente, o valor de domínio é o domínio em que a conta de usuário reside.

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

-VIP

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro VIP especifica se o usuário é uma conta de prioridade. Os valores válidos são:

  • $true: o usuário é uma conta de prioridade.
  • $false: o usuário não é uma conta de prioridade.

Para obter mais informações sobre contas prioritárias, consulte Gerenciar e monitorar contas prioritárias.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-WebPage

O parâmetro WebPage especifica a página da Web do usuário.

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, Exchange Online, Exchange Online Protection

-WhatIf

A opção WhatIf não funciona neste cmdlet.

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, Exchange Online, Exchange Online Protection

-WindowsEmailAddress

O parâmetro WindowsEmailAddress especifica o endereço de email do Windows para este destinatário. Esse é um atributo comum do Active Directory que está presente em todos os ambientes, incluindo ambientes sem Exchange. Usar o parâmetro WindowsEmailAddress em um destinatário tem um dos seguintes resultados:

  • Em ambientes em que o destinatário está sujeito a políticas de endereço de email (a propriedade EmailAddressPolicyEnabled é definida como o valor True para o destinatário), o parâmetro WindowsEmailAddress não tem efeito na propriedade WindowsEmailAddress ou no valor endereço de email principal.
  • Em ambientes em que o destinatário não está sujeito a políticas de endereço de email (a propriedade EmailAddressPolicyEnabled é definida como o valor False para o destinatário), o parâmetro WindowsEmailAddress atualiza a propriedade WindowsEmailAddress e o endereço de email principal para o mesmo valor.

A propriedade WindowsEmailAddress é visível para o destinatário em Usuários e Computadores do Active Directory no atributo E-mail. O nome comum do atributo é E-mail-Addresses e o Ldap-Display-Name é email. Se você modificar esse atributo no Active Directory, o endereço de email principal do destinatário não será atualizado para o mesmo valor.

Type:SmtpAddress
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, Exchange Online, Exchange Online Protection

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.