Set-User (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-06-05
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> [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-WindowsEmailAddress <SmtpAddress>]
set-User [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-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:
|
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. |
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. |
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. |
Anotações |
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 versões 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 em caracteres ASCII de 26 a 126, inclusive. |
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. |
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. |
WebPage |
Opcional |
System.String |
O parâmetro WebPage define a página da Web do usuário. |
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 |
|---|---|
|
|
Exemplo
No exemplo a seguir, o comando Set-User é usado para definir o nome para exibição do usuário Ted Bremer.
Set-User -Identity Contoso\Ted -DisplayName "Ted Bremer"