Set-User

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2011-01-12

Use o cmdlet Set-User para modificar os atributos do usuário no serviço de diretório do Active Directory.

Sintaxe

set-User -Identity <UserIdParameter> [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

set-User [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-Instance <User>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Descrição detalhada

O cmdlet Set-User modifica os atributos de um usuário existente no Active Directory.

Para executar o cmdlet Set-User, você deve usar uma conta à qual esteja delegado o seguinte:

• Função Administrador de Destinatários do Exchange

• Função de Operador de Conta para os contêineres do Active Directory aplicáveis 

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro	Necessário	Tipo	Descrição
Identity	Necessário	Microsoft.Exchange.Configuration.Tasks.UserIdParameter	O parâmetro Identity adota um dos seguintes valores: GUID DN (nome distinto) Domínio\Conta Nome UPN DN Herdado do Exchange Endereço SMTP Alias
AllowUMCallsFromNonUsers	Optional	Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags	Este parâmetro especifica se o usuário deve ser excluído das pesquisas de diretório.
AssistantName	Opcional	System.String	O parâmetro AssistantName define o nome do assistente do usuário.
City	Opcional	System.String	O parâmetro City define a cidade do usuário.
Company	Opcional	System.String	O parâmetro Company define a empresa do usuário.
Confirm	Optional	System.Management.Automation.SwitchParameter	O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.
CountryOrRegion	Opcional	Microsoft.Exchange.Data.Directory.CountryInfo	O parâmetro CountryOrRegion define o país ou a região do usuário.
CreateDTMFMap	Opcional	System.Boolean	Esse parâmetro determina a criação de um mapa de multifreqüência de tom dual (DTMF) para o usuário.
Department	Opcional	System.String	O parâmetro Department define o departamento do usuário.
DisplayName	Opcional	System.String	O parâmetro DisplayName define o nome para exibição do usuário.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController no comando.
Fax	Opcional	System.String	O parâmetro Fax define o número de fax do usuário.
FirstName	Opcional	System.String	O parâmetro FirstName define o nome fornecido do usuário.
HomePhone	Opcional	System.String	O parâmetro HomePhone define o número de telefone residencial do usuário.
IgnoreDefaultScope	Optional	System.Management.Automation.SwitchParameter	O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração padrão de escopo do destinatário do Shell de Gerenciamento do Exchange e usar toda a floresta como o escopo. Isso permite que o comando acesse objetos do Active Directory que não estão atualmente no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições: Você não pode usar o parâmetro DomainController. O comando usará automaticamente um servidor de catálogo global adequado. Você pode usar o DN somente para o parâmetro Identity. Outras formas de identificação, como alias ou GUID, não são aceitas.
Initials	Opcional	System.String	O parâmetro Initials define as iniciais do usuário.
Instance	Opcional	Microsoft.Exchange.Data.Directory.Management.User	O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.
LastName	Opcional	System.String	O parâmetro LastName define o sobrenome do usuário.
Manager	Opcional	Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter	O parâmetro Manager define o gerente do usuário.
MobilePhone	Opcional	System.String	O parâmetro MobilePhone define o número de celular principal do usuário.
Name	Opcional	System.String	O parâmetro Name define o nome comum do usuário.
Notes	Opcional	System.String	O parâmetro Notes define informações adicionais sobre o usuário.
Office	Opcional	System.String	O parâmetro Office define o nome ou número do escritório físico do usuário.
OtherFax	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro OtherFax define o número alternativo de fax do usuário.
OtherHomePhone	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro OtherHomePhone define o número alternativo do telefone residencial do usuário.
OtherTelephone	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro OtherTelephone define o número alternativo de telefone do usuário.
Pager	Opcional	System.String	O parâmetro Pager define o número do pager do usuário.
Phone	Opcional	System.String	O parâmetro Phone define o número de telefone do escritório do usuário.
PhoneticDisplayName	Opcional	System.String	O parâmetro PhoneticDisplayName especifica uma pronúncia fonética do parâmetro DisplayName. O tamanho máximo desse valor de parâmetro é 255 caracteres. Para obter mais informações sobre o parâmetro PhoneticDisplayName e reconhecimento de fala, consulte Compreendendo pesquisas de diretório de Reconhecimento Automático de Fala.
PostalCode	Opcional	System.String	O parâmetro PostalCode define o CEP do usuário.
PostOfficeBox	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro PostOfficeBox define o número da caixa postal do usuário.
ResetPasswordOnNextLogon	Opcional	System.Boolean	O parâmetro ResetPasswordOnNextLogon indica se a senha especificada no parâmetro Password deve ser redefinida na próxima vez em que o usuário fizer logon. O valor padrão é $true.
SamAccountName	Opcional	System.String	O parâmetro SamAccountName define o nome de logon usado para oferecer suporte a clientes e servidores que executam versoes antigas do sistema operacional, como Microsoft Windows NT 4.0, Windows 98, Windows 95 e LAN Manager. Esse atributo deve conter menos de 20 caracteres.
SimpleDisplayName	Opcional	System.String	O parâmetro SimpleDisplayName é usado para exibir uma descrição alternativa do objeto quando somente um conjunto limitado de caracteres for permitido. Esse conjunto limitado de caracteres consiste nos seguintes caracteres: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?
StateOrProvince	Opcional	System.String	O parâmetro StateOrProvince define o estado ou a província do usuário.
StreetAddress	Opcional	System.String	O parâmetro StreetAddress define o endereço físico do usuário.
TelephoneAssistant	Optional	System.String	O parâmetro TelephoneAssistant define o número de telefone do assistente do usuário.
Title	Opcional	System.String	O parâmetro Title define o cargo do usuário.
UMDialPlan	Opcional	Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter	Esse parâmetro especifica o ID do objeto de diretório para o plano de discagem.
UMDtmfMap	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Esse parâmetro especifica se você deseja criar um mapa de DTMF definido pelo usuário para o usuário habilitado para UM.
UserPrincipalName	Opcional	System.String	O parâmetro UserPrincipalName define o nome UPN do usuário.
UseRusServer	Opcional	System.String	Observação: Esse parâmetro está disponível somente no Exchange 2007 SP2. O parâmetro UseRusServer instrui o comando a usar o servidor Caixa de Correio especificado no qual o serviço Lista de Endereços está sendo executado para obter e definir atributos de caixa de correio e de usuário do Active Directory. O serviço Lista de Endereços é um componente do serviço Atendedor do Sistema do Exchange. O serviço Lista de Endereços cria e mantém valores de atributo específicos do Exchange no Active Directory. O serviço Lista de Endereços pode ser usado para atualizar objetos de destinatário em um domínio usando informações específicas, como a associação na lista de endereços e endereços de email.
WebPage	Opcional	System.String	O parâmetro WebPage define a página da Web do usuário.
WhatIf	Optional	System.Management.Automation.SwitchParameter	O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.
WindowsEmailAddress	Opcional	Microsoft.Exchange.Data.SmtpAddress	O parâmetro WindowsEmailAddress especifica o endereço de email do destinatário.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplos

Descrição

No exemplo a seguir, o comando Set-User é usado para definir o nome para exibição do usuário Ted Bremer.

Código

Set-User -Identity Contoso\Ted -DisplayName "Ted Bremer" 

Descrição

No exemplo a seguir, o comando Set-User é usado para remover o valor -manager. Para fazer isso, é preciso especificar $null da seguinte forma.

Código

Set-User -Identity Contoso\Ted -manager $null