Set-Contact
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2009-05-12
Use o cmdlet Set-Contact para modificar as configurações de um contato existente.
Sintaxe
Set-Contact -Identity <ContactIdParameter> [-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>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
Set-Contact [-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 <Contact>] [-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>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
Descrição detalhada
Você pode usar o cmdlet Set-Contact para modificar as configurações de objetos de contato visíveis em Usuários e Computadores do Active Directory. Se o contato estiver habilitado para email, use o cmdlet Set-MailContact para modificar as configurações de email do contato que não estão disponíveis usando o cmdlet Set-Contact.
Para executar o cmdlet Set-Contact, você deve usar a conta à qual estejam delegadas as seguintes funções:
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.ContactIdParameter |
O parâmetro Identity especifica o objeto que você deseja modificar. O parâmetro Identity pode obter qualquer um dos seguintes valores para o objeto de contato:
O parâmetro Identity não poderá ser usado se o parâmetro Instance estiver especificado. |
||
AllowUMCallsFromNonUsers |
Opcional |
Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags |
Esse parâmetro especifica se o contato deve ser excluído das pesquisas de diretório. |
||
AssistantName |
Opcional |
System.String |
O parâmetro AssistantName define o nome do assistente do contato. |
||
City |
Opcional |
System.String |
O parâmetro City define a cidade do contato. |
||
Company |
Opcional |
System.String |
O parâmetro Company define a empresa do contato. |
||
Confirm |
Opcional |
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 contato. |
||
CreateDTMFMap |
Opcional |
System.Boolean |
Esse parâmetro determina a criação de um mapa de multifreqüência de tom dual (DTMF) para o contato. |
||
Department |
Opcional |
System.String |
O parâmetro Department define o departamento do contato. |
||
DisplayName |
Opcional |
System.String |
Você pode usar o parâmetro DisplayName para especificar o nome do contato no Console de Gerenciamento do Exchange e na GAL (lista de endereços global) do Exchange. DisplayName tem significado apenas para objetos habilitados para email. |
||
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 serviço de diretório do Active Directory, inclua o parâmetro DomainController. |
||
Fax |
Opcional |
System.String |
O parâmetro Fax define o número de fax do contato. |
||
FirstName |
Opcional |
System.String |
O parâmetro FirstName define o nome do contato. |
||
HomePhone |
Opcional |
System.String |
O parâmetro HomePhone define o número de telefone residencial do contato. |
||
IgnoreDefaultScope |
Opcional |
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:
|
||
Initials |
Opcional |
System.String |
O parâmetro Initials define as iniciais do nome do contato. |
||
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.Management.Contact |
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. O parâmetro Instance não poderá ser usado se o parâmetro Identity estiver especificado. |
||
LastName |
Opcional |
System.String |
O parâmetro LastName define o sobrenome do contato. |
||
Manager |
Opcional |
Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter |
O parâmetro Manager define o gerente do contato. |
||
MobilePhone |
Opcional |
System.String |
O parâmetro MobilePhone define o número de celular principal do contato. |
||
Name |
Opcional |
System.String |
O parâmetro Name especifica o nome do contato em Usuários e Computadores do Active Directory e também no campo Nome do Grupo no Console de Gerenciamento do Exchange se o grupo estiver habilitado para email. O valor Name não pode exceder 64 caracteres. |
||
Notes |
Opcional |
System.String |
O parâmetro Notes define informações adicionais sobre o contato. |
||
Office |
Opcional |
System.String |
O parâmetro Office define o nome ou número de escritório do contato. |
||
OtherFax |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro OtherFax define o número de fax alternativo do contato. |
||
OtherHomePhone |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro OtherHomePhone define o número de telefone residencial alternativo do contato. |
||
OtherTelephone |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro OtherTelephone define o número de telefone de escritório alternativo do contato. |
||
Pager |
Opcional |
System.String |
O parâmetro Pager define o número de pager do contato. |
||
Phone |
Opcional |
System.String |
O parâmetro Phone define o número de telefone de escritório do contato. |
||
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 contato. |
||
PostOfficeBox |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro PostOfficeBox define o número de caixa postal do contato. |
||
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\"()+,-./:? SimpleDisplayName tem significado apenas para objetos habilitados para email. |
||
StateOrProvince |
Opcional |
System.String |
O parâmetro StateOrProvince define o estado ou a província do contato. |
||
StreetAddress |
Opcional |
System.String |
O parâmetro StreetAddress define o endereço físico do contato. |
||
TelephoneAssistant |
Opcional |
System.String |
O parâmetro TelephoneAssistant define o número de telefone do assistente do contato. |
||
Title |
Opcional |
System.String |
O parâmetro Title define o cargo do contato. |
||
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 contato habilitado para UM. |
||
UseRusServer |
Optional |
System.String |
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 contato. |
||
WhatIf |
Opcional |
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 contato armazenado no Active Directory. |
.gif "note")
Observação:Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
|
Exceções
| Exceções | Descrição |
|---|---|
|
|
Exemplo
O exemplo de código a seguir mostra como usar o comando Set-Contact para fazer as seguintes alterações em um contato existente, chamado Ted Bremer, no contêiner Users no domínio do Active Directory denominado contoso.com:
Alterar o valor Cidade para Seattle.
Alterar o valor Empresa para Contoso.
Set-Contact -Identity "contoso.com/Users/Ted Bremer" -City "Seattle" -Company "Contoso"