Compartilhar via


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.

Utilize o cmdlet Set-User para modificar os atributos do utilizador. Pode utilizar este cmdlet para modificar todos os objetos que têm contas de utilizador (por exemplo, caixas de correio de utilizador, utilizadores de correio e contas de utilizador).

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

Sintaxe

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>]
   [-EXOModuleEnabled <Boolean>]
   [-Fax <String>]
   [-FirstName <String>]
   [-Force]
   [-GeoCoordinates <GeoCoordinates>]
   [-HomePhone <String>]
   [-IgnoreDefaultScope]
   [-IsShadowMailbox <Boolean>]
   [-Initials <String>]
   [-LastName <String>]
   [-LinkedCredential <PSCredential>]
   [-LinkedDomainController <String>]
   [-LinkedMasterAccount <UserIdParameter>]
   [-MailboxRegion <String>]
   [-MailboxRegionSuffix <MailboxRegionSuffixValue>]
   [-ManagedOnboardingType <ManagedOnboardingType>]
   [-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 com correio para caixas de correio ou utilizadores de correio. Para modificar as propriedades relacionadas com o correio de um utilizador, tem de utilizar 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 desassocia a caixa de correio Kweku@fabrikam.com ligada e converte-a numa caixa de correio de utilizador ao definir o parâmetro LinkedMasterAccount para $null.

A execução deste procedimento numa caixa de correio ligada remove todas as permissões na caixa de correio, como Enviar Como, Acesso Total, 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 pretende excluir o utilizador das pesquisas de diretórios de Mensagens Unificadas.

Tipo:AllowUMCallsFromNonUsersFlags
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Arbitration

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

O comutador de Arbitragem é necessário 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 que são utilizadas para armazenar diferentes tipos de dados do sistema e para gerir o fluxo de trabalho de aprovação de mensagens.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 aplicar ao utilizador. É 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 utilizador, utilize o valor $null.

Crie 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 legados.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2019, Exchange Online, Exchange Online Protection

-BlockCloudCache

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

{{ Fill BlockCloudCache Description }}

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Exchange Online Protection

-CanHaveCloudCache

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

{{ Fill CanHaveCloudCache Description }}

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:MultiValuedProperty
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-City

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

{{ Fill ClearDataEncryptionPolicy Description }}

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Exchange Online Protection

-Company

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 iso 3166-1 de duas letras válido (por exemplo, AU para a Austrália) ou o nome amigável correspondente para o país (que pode ser diferente do nome abreviado oficial da Iso 3166 Maintenance Agency).

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

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

Tipo:CountryInfo
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 pretende criar um mapa de múltiplas frequências (DTMF) de duplo tom para o destinatário. Isto permite que o destinatário seja identificado através de um teclado telefónico em ambientes de Unified Messaging (UM). Os valores válidos são:

  • $true: é criado um mapa DTMF para o destinatário. Esse é o valor padrão.
  • $true: um mapa DTMF foi criado para o destinatário. Este é o valor padrão.
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Department

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

{{ Fill DesiredWorkloads Description }}

Tipo:Microsoft.Exchange.Data.MailboxWorkloadFlags
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Exchange Online Protection

-DisplayName

O parâmetro DisplayName especifica o nome para exibição do usuário. O nome a apresentar é 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 (").

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:Fqdn
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-EXOModuleEnabled

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

O parâmetro EXOModuleEnabled especifica se o utilizador se pode ligar ao Exchange Online PowerShell em organizações do Microsoft 365 com o módulo Exchange Online PowerShell V3. Os valores válidos são:

  • $true: o utilizador pode ligar-se ao Exchange Online PowerShell.
  • $false: o utilizador não consegue ligar-se ao Exchange Online PowerShell.

O valor predefinido depende das funções de gestão atribuídas ao utilizador.

O acesso ao Exchange Online PowerShell também é necessário para outras funcionalidades (por exemplo, a capacidade de abrir o Centro de administração do Exchange (EAC)).

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Exchange Online Protection

-Fax

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

O comutador 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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Exchange Online Protection

-GeoCoordinates

O parâmetro GeoCoordinates especifica a localização do utilizador nas coordenadas de latitude, longitude e altitude (opcionalmente). Um valor válido para este parâmetro utiliza 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"

Nota: se os separadores de período não funcionarem para si, utilize vírgulas.

Tipo:GeoCoordinates
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Identity

O parâmetro Identidade especifica o utilizador que pretende 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
Tipo:UserIdParameter
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False
Aplica-se a: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.

O comutador IgnoreDefaultScope indica ao comando para ignorar a definição de âmbito de destinatário predefinida para a sessão do Exchange PowerShell e utilizar toda a floresta como âmbito. Não é preciso especificar um valor com essa opção.

Este comutador permite que o comando aceda a objetos do Active Directory que não estão atualmente disponíveis no âmbito predefinido, 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.
Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IsShadowMailbox

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

{{ Fill IsShadowMailbox Description }}

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Exchange Online Protection

-LastName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 utilizador e a palavra-passe utilizados para aceder ao 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.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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
  • Domínio\Conta
  • 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.

Tipo:UserIdParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

{{ Fill MailboxRegion Description }}

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online

-MailboxRegionSuffix

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

{{ Preencher Caixa de CorreioRegiãoSufixo Descrição }}

Tipo:MailboxRegionSuffixValue
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online

-ManagedOnboardingType

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

{{ Fill ManagedOnboardingType Description }}

Tipo:ManagedOnboardingType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Exchange Online Protection

-Manager

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

Tipo:UserContactIdParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Nota: no Exchange Online, não pode utilizar este parâmetro. Em vez disso, utilize o parâmetro MobilePhone no cmdlet Update-MgUser no Microsoft Graph PowerShell.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 utilizador. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 (").

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:MultiValuedProperty
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:MultiValuedProperty
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:MultiValuedProperty
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PermanentlyClearPreviousMailboxInfo

Esse parâmetro só é funcional no serviço baseado em nuvem.

O comutador PermanentlyClearPreviousMailboxInfo especifica se deve limpar os atributos Exchange Online caixa de correio num utilizador. Não é preciso especificar um valor com essa opção.

Pode ser necessário limpar estes atributos nos cenários de movimentação e reinscrição da caixa de correio entre o Exchange no local e o Microsoft 365. Para obter mais informações, consulte Limpar Permanentemente Informações da Caixa de Correio Anterior.

Atenção: este comutador impede-o de voltar a ligar-se à caixa de correio e impede-o de recuperar conteúdo da caixa de correio.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Phone

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

Nota: no Exchange Online, não pode utilizar este parâmetro. Em vez disso, utilize o parâmetro BusinessPhones no cmdlet Update-MgUser no Microsoft Graph PowerShell.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 (").

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:MultiValuedProperty
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PublicFolder

O comutador PublicFolder é necessário para modificar caixas de correio de pastas públicas. 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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-RemotePowerShellEnabled

Nota: em ambientes baseados na cloud, este parâmetro está a ser preterido, pelo que deve utilizar o parâmetro EXOModuleEnabled.

O parâmetro RemotePowerShellEnabled especifica se o utilizador tem acesso ao Exchange PowerShell. Os valores válidos são:

  • $true: o utilizador tem acesso ao Exchange Online PowerShell, à Shell de Gestão do Exchange e ao Centro de administração do Exchange (EAC).
  • $false: o utilizador não tem acesso ao Exchange Online PowerShell, à Shell de Gestão do Exchange ou ao EAC.

O valor predefinido depende das funções de gestão atribuídas ao utilizador.

O acesso ao Exchange PowerShell é necessário mesmo que esteja a tentar abrir a Shell de Gestão do Exchange ou o EAC no servidor Exchange local.

A experiência de um usuário em qualquer uma dessas interfaces de gerenciamento ainda é controlada pelas permissões do controle de acesso com base em função (RBAC) atribuídas a ele.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Exchange Online Protection

-ResetPasswordOnNextLogon

O parâmetro ResetPasswordOnNextLogon especifica se o utilizador tem de alterar a palavra-passe da próxima vez que iniciar sessão. Os valores válidos são:

  • $true: o utilizador tem de alterar a palavra-passe da próxima vez que iniciar sessão.
  • $false: o utilizador não tem de alterar a palavra-passe da próxima vez que iniciar sessão. Esse é o valor padrão.
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 a conta de utilizador ou nome de grupo anterior ao Windows 2000) especifica um identificador de objeto compatível com versões mais antigas dos sistemas operativos de servidor e cliente do Microsoft Windows. O valor pode conter letras, números, espaços, pontos finais (.) e os seguintes carateres: !, #, $, %, ^, &, -, _, {, }e ~. O último caráter não pode ser um ponto final. Os carateres Unicode são permitidos, mas os carateres acentuados podem gerar colisões (por exemplo, o e ö correspondem). O comprimento máximo é de 20 carateres.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SimpleDisplayName

O parâmetro SimpleDisplayName é utilizado para apresentar uma descrição alternativa do objeto quando apenas é permitido um conjunto limitado de carateres. Os carateres 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
  • " ' ( ) + , - . / : ?
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2016, Exchange Server 2019

-StateOrProvince

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 a partir da qual os tokens de atualização sts do utilizador 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 utilizar o formato de data abreviada MM/dd/aaaa, introduza 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".

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Title

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:MultiValuedProperty
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 de múltipla frequência (DTMF) de tons duplos para o destinatário. Isto permite que o destinatário seja identificado através de um teclado telefónico em ambientes de Unified Messaging (UM). Normalmente, estes valores DTMF são criados e atualizados automaticamente, mas pode utilizar este parâmetro para fazer alterações manualmente. Esse parâmetro aceita a seguinte sintaxe:

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

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

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

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

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

Tipo:MultiValuedProperty
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 utiliza um formato de endereço de e-mail: username@domain. Normalmente, o valor de domínio é o domínio onde reside a conta de utilizador.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 utilizador é uma conta de prioridade. Os valores válidos são:

  • $true: o utilizador é uma conta prioritária.
  • $false: o utilizador não é uma conta prioritária.

Para obter mais informações sobre contas prioritárias, veja Gerir e monitorizar contas prioritárias.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Exchange Online, Exchange Online Protection

-WebPage

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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 e-mail do Windows para este destinatário. Este é um atributo comum do Active Directory que está presente em todos os ambientes, incluindo ambientes sem o Exchange. A utilização do parâmetro WindowsEmailAddress num destinatário tem um dos seguintes resultados:

  • Em ambientes onde o destinatário está sujeito a políticas de endereço de e-mail (a propriedade EmailAddressPolicyEnabled está definida como o valor Verdadeiro para o destinatário), o parâmetro WindowsEmailAddress não tem qualquer efeito na propriedade WindowsEmailAddress ou no valor endereço de email principal.
  • Em ambientes onde o destinatário não está sujeito a políticas de endereço de e-mail (a propriedade EmailAddressPolicyEnabled está definida como o valor Falso 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 está visível para o destinatário no Usuários e Computadores do Active Directory no atributo E-mail. O nome comum do atributo é Endereços de Correio Eletrónico e Ldap-Display-Name é correio. Se modificar este atributo no Active Directory, a endereço de email principal do destinatário não será atualizada para o mesmo valor.

Tipo:SmtpAddress
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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.