Set-User

Módulo:: Exchange PowerShell

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 ambiente ou de outro.

Use o cmdlet Set-User para modificar os atributos do usuário. Você pode usar esse cmdlet para modificar todos os objetos que tenham 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.

Sintaxe

Default (Default)

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 a 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 artigo 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 de usuário definindo o parâmetro LinkedMasterAccount como $null.

Realizar este procedimento em uma caixa de correio vinculada remove todas as permissões na caixa de correio, como Enviar Como, Acesso Total, delegação de pasta e 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 ser excluído das pesquisas de diretório da Unificação de Mensagens.

Propriedades do parâmetro

Tipo:	AllowUMCallsFromNonUsersFlags
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Arbitration

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

A opção de arbitragem é necessária para modificar as 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.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-AssistantName

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-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 herdados.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-BlockCloudCache

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

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-CanHaveCloudCache

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

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

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

Propriedades do parâmetro

Tipo:	MultiValuedProperty
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-City

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ClearDataEncryptionPolicy

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Company

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer o comando antes de continuar.

Este cmdlet tem uma pausa interna, portanto, use -Confirm:$false para ignorar a confirmação.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	cf

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-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 abreviado oficial da Agência de Manutenção ISO 3166).

Uma referência para códigos de país de duas letras está disponível em 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 do país de duas letras nas operações de filtro.

Propriedades do parâmetro

Tipo:	CountryInfo
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-CreateDTMFMap

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

O parâmetro CreateDTMFMap especifica se um mapa DTMF (frequência múltipla de dois tons) deve ser criado para o destinatário. Isso permite que o destinatário seja identificado usando um teclado telefônico em ambientes de Unificação de Mensagens (UM). Os valores válidos são:

$true: Um mapa DTMF é criado para o destinatário. Esse valor é o padrão.
$true: um mapa DTMF foi criado para o destinatário. Este é o valor padrão.

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Department

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-DesiredWorkloads

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

Propriedades do parâmetro

Tipo:	Microsoft.Exchange.Data.MailboxWorkloadFlags
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-DisplayName

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

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

Propriedades do parâmetro

Tipo:	Fqdn
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-EXOModuleEnabled

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

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

$true: O usuário pode se conectar ao Exchange Online PowerShell.
$false: o usuário não pode se conectar ao Exchange Online PowerShell.

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

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

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Fax

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-FirstName

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-GeoCoordinates

O parâmetro GeoCoordinates especifica a localização do usuário em coordenadas de latitude, longitude e (opcionalmente) altitude. Um valor válido para esse 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 ponto final não funcionarem, use vírgulas.

Propriedades do parâmetro

Tipo:	GeoCoordinates
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-HomePhone

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-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

Propriedades do parâmetro

Tipo:	UserIdParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	1
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-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 de destinatário padrão para a sessão do PowerShell do Exchange e usar toda a floresta como 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.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Initials

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-IsShadowMailbox

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

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-LastName

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

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

Propriedades do parâmetro

Tipo:	PSCredential
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-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

Se você definir o valor deste parâmetro como $null, você desvincula a conta e converte a caixa de correio vinculada em uma caixa de correio de usuário não vinculada. A caixa de correio não mantém as permissões definidas anteriormente (por exemplo, Enviar Como, Acesso Total, permissões de pasta e delegação de calendário).

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

Propriedades do parâmetro

Tipo:	UserIdParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-MailboxRegion

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-MailboxRegionSuffix

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

Propriedades do parâmetro

Tipo:	MailboxRegionSuffixValue
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ManagedOnboardingType

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

Propriedades do parâmetro

Tipo:	ManagedOnboardingType
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Manager

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

Propriedades do parâmetro

Tipo:	UserContactIdParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-MobilePhone

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

No Exchange Online, você também pode usar o parâmetro MobilePhone no cmdlet Update-MgUser no Microsoft Graph PowerShell.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Name

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Notes

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Office

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-OtherFax

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

Propriedades do parâmetro

Tipo:	MultiValuedProperty
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-OtherHomePhone

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

Propriedades do parâmetro

Tipo:	MultiValuedProperty
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-OtherTelephone

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

Propriedades do parâmetro

Tipo:	MultiValuedProperty
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

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

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-PermanentlyClearPreviousMailboxInfo

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

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

A limpeza desses atributos pode ser necessária em cenários de movimentação e relicenciamento de caixa de correio entre o Exchange local e o Microsoft 365. Para obter mais informações, consulte Limpar permanentemente informações de caixa de correio anterior.

Cuidado: essa opção impede que você se reconecte à caixa de correio e recupere o conteúdo da caixa de correio.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Phone

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

No Exchange Online, você também pode usar o parâmetro BusinessPhones no cmdlet Update-MgUser no Microsoft Graph PowerShell.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-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 (").

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-PostalCode

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-PostOfficeBox

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

Propriedades do parâmetro

Tipo:	MultiValuedProperty
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-PublicFolder

A opção PublicFolder é necessária para modificar as 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.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-RemotePowerShellEnabled

Observação: em ambientes baseados em nuvem, esse parâmetro será descontinuado. Em vez disso, recomendamos usar o parâmetro EXOModuleEnabled.

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

$true: o usuário tem acesso ao Exchange Online PowerShell, ao Shell de Gerenciamento do Exchange e ao EAC (centro de administração do Exchange).
$false: o usuário não tem acesso ao Exchange Online PowerShell, ao Shell de Gerenciamento do Exchange ou ao EAC.

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

O acesso ao PowerShell do Exchange é necessário mesmo se você estiver tentando abrir o Shell de Gerenciamento 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.

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-RemoveMailboxProvisioningConstraint

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

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ResetPasswordOnNextLogon

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

$true: O usuário precisa alterar a senha na próxima vez que fizer logon.
$false: O usuário não precisa alterar a senha na próxima vez que fizer logon. Esse valor é o padrão.

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-SamAccountName

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

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-SeniorityIndex

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

Propriedades do parâmetro

Tipo:	Int32
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-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
" ' ( ) + , - . / : ?

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-SkipDualWrite

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

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-StateOrProvince

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-StreetAddress

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-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 do 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/aaaa, 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".

Propriedades do parâmetro

Tipo:	DateTime
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Title

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-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. Esse parâmetro aceita dígitos com menos de 128 caracteres de comprimento e pode incluir um sinal de adição opcional (+) antes dos números. Cada usuário habilitado para UM deve ter um valor do parâmetro UMCallingLineIds exclusivo.

Propriedades do parâmetro

Tipo:	MultiValuedProperty
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-UMDtmfMap

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

O parâmetro UMDtmfMap especifica os valores de mapa DTMF (frequência múltipla de tom duplo) para o destinatário. Isso permite que o destinatário seja identificado usando um teclado telefônico em ambientes de Unificação de Mensagens (UM). 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 substituam 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 do mapa DTMF, esses valores serão removidos do destinatário. Por exemplo, se você especificar apenas emailAddress:<integers>, todos os valores lastNameFirstName e firstNameLastName existentes 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 poderá especificar vários valores de mapa DTMF. Por exemplo, você pode adicionar @{Add="emailAddress:<integers1>","emailAddress:<integers2>} dois novos valores para emailAddress sem afetar os valores lastNameFirstName e firstNameLastName existentes.

Propriedades do parâmetro

Tipo:	MultiValuedProperty
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-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 do domínio é o domínio em que a conta de usuário reside.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-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 prioritária. Os valores válidos são:

$true: O usuário é uma conta prioritária.
$false: O usuário não é uma conta prioritária.

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

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-WebPage

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-WhatIf

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	wi

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-WindowsEmailAddress

O parâmetro WindowsEmailAddress especifica o endereço de email do Windows para esse destinatário. Esse é um atributo comum do Active Directory que está presente em todos os ambientes, inclusive ambientes sem o Exchange. O uso do 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 com o valor True para o destinatário), o parâmetro WindowsEmailAddress não tem efeito sobre a propriedade WindowsEmailAddress ou o valor do 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 com 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 é Endereços de Email e o Nome de Exibição do LDAP é 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.

Propriedades do parâmetro

Tipo:	SmtpAddress
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

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.

Comentários

Esta página foi útil?