Set-Contact (RTM)

Artigo
09/30/2014

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-17

Use o cmdlet Set-Contact para modificar as configurações de um contato existente.

Sintaxe

Set-Contact -Identity <ContactIdParameter> [-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>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-WebPage <String>]

Set-Contact [-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 <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>] [-WebPage <String>]

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 obter mais informações sobre o cmdlet Set-MailContact, consulte Set-MailContact (RTM).

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: GUID DN (nome distinto) Nome canônico Name O parâmetro Identity não poderá ser usado se o parâmetro Instance estiver especificado.
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.
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.
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.
Anotações	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 em caracteres ASCII de 26 a 126, inclusive. 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.
WebPage	Opcional	System.String	O parâmetro WebPage define a página da Web do contato.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceçõ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"

Compartilhar via