Set-Contact

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

O parâmetro AllowUMCallsFromNonUsers especifica se o contato deve ser excluído das pesquisas de diretório de Mensagens Unificadas.

O parâmetro AssistantName especifica o nome do assistente do contato.

O parâmetro City especifica a cidade do contato.

O parâmetro Company especifica a empresa do contato.

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

• Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, cmdlets 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 confirmar o comando antes de continuar.

O parâmetro CountryOrRegion especifica o país ou a região do contato. 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 curto oficial da Agência de Manutenção iso 3166).

Uma referência para códigos de país de duas letras está disponível na Lista de Códigos de País.

O nome amigável é retornado no valor da propriedade CountryOrRegion pelo cmdlet Get-Contact, mas você pode usar o nome amigável ou o código de país de duas letras em operações de filtro.

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

O parâmetro CreateDTMFMap especifica se é necessário criar um mapa DTMF (dupla frequência múltipla) para o destinatário. Isso permite que o destinatário seja identificado usando um teclado telefônico em ambientes de UM (Mensagens Unificadas). Os valores válidos são:

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

O parâmetro Department especifica o departamento do contato.

O parâmetro DisplayName especifica o nome de exibição do contato. O nome de exibição está visível no centro de administração do Exchange e nas listas de endereços. O comprimento máximo é de 256 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Esse parâmetro só será significativo se o contato estiver habilitado para email.

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.

O parâmetro Fax especifica o número de fax do contato.

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

O parâmetro GeoCoordinates especifica o local do contato em coordenadas de latitude, longitude e (opcionalmente) altitude. Um valor válido para este 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 período não funcionarem para você, use vírgulas.

O parâmetro HomePhone especifica o número do telefone residencial do contato.

O parâmetro Identity especifica o contato que você deseja modificar. É possível usar qualquer valor que identifique o contato com exclusividade. Por exemplo:

• Nome
• DN (nome diferenciado)
• Nome diferenciado (DN)
• GUID

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

A opção IgnoreDefaultScope informa ao comando para ignorar a configuração de escopo padrão do destinatário para a sessão do Exchange PowerShell e usar toda a floresta como o 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.

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

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

O parâmetro Manager especifica o gerente do contato.

O parâmetro MobilePhone especifica o número do telefone celular principal do contato.

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

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

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

O parâmetro OtherFax especifica o número alternativo de fax do contato.

O parâmetro OtherHomePhone especifica o número alternativo do telefone residencial do contato.

O parâmetro OtherTelephone especifica o número alternativo do telefone do escritório do contato.

O parâmetro Pager especifica o número do pager do contato.

O parâmetro Phone especifica o número do telefone do escritório do contato.

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

O parâmetro PostalCode especifica o CEP do contato.

O parâmetro PostOfficeBox especifica o número de caixa postal do contato.

O parâmetro SeniorityIndex especifica a ordem em que este contato será exibido em um catálogo de endereços hierárquico. Um contato com o valor 2 aparecerá mais alto em um catálogo de endereços que em um contato com o valor 1.

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

Esse parâmetro só será significativo se o contato estiver habilitado para email.

O parâmetro StateOrProvince especifica o estado ou a província do contato.

O parâmetro StreetAddress especifica o endereço físico do contato.

O parâmetro TelephoneAssistant especifica o número de telefone do assistente do contato.

O parâmetro Title especifica o título do contato.

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. Os valores para este parâmetro devem ser menores que 128 caracteres em comprimento e podem incluir um sinal de mais (+) opcional que precede os números. Cada usuário habilitado para UM deve ter um valor do parâmetro UMCallingLineIds exclusivo.

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

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

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

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

O parâmetro WindowsEmailAddress especifica o endereço de email do Windows para este destinatário. Esse é um atributo comum do Active Directory que está presente em todos os ambientes, incluindo ambientes sem Exchange. Usar o 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 como o valor True para o destinatário), o parâmetro WindowsEmailAddress não tem efeito na propriedade WindowsEmailAddress ou no valor do endereço de email primário.
• Em ambientes em que o destinatário não está sujeito a políticas de endereço de email (a propriedade EmailAddressPolicyEnabled é definida como o valor False para o destinatário), o parâmetro WindowsEmailAddress atualiza a propriedade WindowsEmailAddress e o endereço de email primário 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 é E-mail-Addresses e o Ldap-Display-Name é 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.