Compartilhar via

  • Artigo

Set-CsExUmContact

 

Tópico modificado em: 2012-03-25

Modifica um objeto de contato existente de Atendedor Automático e Acesso de Assinante do Unificação de Mensagens (UM) do Exchange hospedado.

Sintaxe

Set-CsExUmContact -Identity <UserIdParameter> [-AutoAttendant <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Microsoft Lync Server 2010 funciona com o UM do Exchange para fornecer várias capacidades relacionadas à voz, incluindo o Atendedor Automático e o Acesso de Assinante. Quando o UM do Exchange é disponibilizado como um serviço hospedado (e não em uma implementação local), os objetos de contato devem ser criados usando-se Windows PowerShell, para aplicar as funcionalidades Acesso de Assinante e Atendedor Automático. Esses objetos são criados chamando-se o cmdlet New-CsExUmContact e podem serem modificados posteriormente usando-se o cmdlet Set-CsExUmContact.

O modo mais fácil de usar este cmdlet consiste em chamar primeiramente Get-CsExUmContact para recuperar uma instância do objeto de contato que você deseja modificar. Canalize a saída do comando Get-CsExUmContact para o cmdlet Set-CsExUmContact e atribua valores aos parâmetros das propriedades que você deseja modificar. (Para obter detalhes, consulte a seção Exemplos, neste tópico). Como alternativa, é possível chamar o cmdlet Set-CsExUmContact, passando-lhe a Identidade do objeto de contato que você deseja modificar.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsExUmContact localmente: RTCUniversalUserAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsExUmContact"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

UserIdParameter

O identificador exclusivo do objeto de contato que se deseja modificar. As Identidades de contato podem ser especificadas usando um de quatro formatos: 1) O endereço SIP do contato, 2) o Nome Principal Universal do usuário (UPN), 3) o nome de domínio do contato e nome de logon, na forma domínio\logon (por exemplo, litwareinc\exum1) e 4) o nome de exibição do Active Directory do contato (por exemplo, Atendedor Automático da Equipe).

Tipo de dados completos: Microsoft.Rtc.Management.AD.UserIdParameter

AutoAttendant

Opcional

Booleano

Defina o parâmetro como Verdadeiro se o objeto de contato for um Atendedor Automático. Por padrão, esse parâmetro é definido como Falso.

Description

Opcional

Cadeia de caracteres

Uma descrição deste contato. A descrição destina-se ao uso, por administradores, para identificar o tipo de contato (Atendedor Automático ou Acesso de Assinante), o local, provedor ou qualquer outra informação que identificará o objetivo de cada contato do UM do Exchange.

DisplayNumber

Opcional

Cadeia de caracteres

O número de telefone do contato. Os números de telefone de cada contato devem ser exclusivos (não pode haver dois contatos do UM do Exchange com o mesmo número de telefone). Alterar este valor também modificará o valor da propriedade LineURI.

Este valor pode começar com um sinal de mais (+) e pode conter qualquer número de dígitos. O primeiro dígito não pode ser zero.

Enabled

Opcional

Booleano

Indica se o contato foi habilitado ou não para o Lync Server 2010. A definição deste parâmetro como Falso desabilitará o contato, e o Atendente Automático ou Acesso de Assinante associado a este contato deixará de funcionar.

Se você inutilizar uma conta usando o parâmetro Habilitado, as informações associadas a esta conta (incluindo as políticas atribuídas de correio de voz hospedadas) serão mantidas. Se você reabilitar posteriormente a conta usando o parâmetro Habilitar, as informações sobre a conta associada serão restauradas.

EnterpriseVoiceEnabled

Opcional

Booleano

Indica se o contato foi habilitado no Enterprise Voice. Se este valor for definido como Falso, o recurso Atendedor Automático ou Acesso de Assinante associado a este contato não estará mais disponível.

SipAddress

Opcional

Cadeia de caracteres

O endereço SIP do contato. Isto deve ser um novo endereço que já não existe como um usuário ou contato no Serviços de Domínio Active Directory (AD DS).

A alteração deste valor também modificará o endereço SIP armazenado na propriedade OtherIpPhone.

O SipAddress pode ser usado como o valor de Identidade para os comandos do Get-CsExUmContact para recuperar contatos específicos. Ao chamar este cmdlet, o novo SipAddress será usado; as consultas para o antigo endereço SIP não devolverão um objeto.

DomainController

Opcional

Fqdn

Permite especificar um controlador de domínio. Se nenhum controlador de domínio for especificado, será utilizado o primeiro disponível.

PassThru

Opcional

SwitchParameter

Retorna os resultados do comando. Por padrão, esse cmdlet não gera saída.

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact. Aceita entradas canalizadas dos objetos de contato do UM do Exchange.

Tipos de Retorno

Esse cmdlet modifica um objeto do tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact. Quando o parâmetro PassThru parameter for utilizado, ele também retornará um objeto desse tipo.

Exemplo

-------------------------- Exemplo 1 --------------------------

Get-CsExUmContact -Identity sip:exumsa4@fabrikam.com | Set-CsExUmContact -AutoAttendant $True

Este exemplo define a propriedade AutoAttendant do contato UM do Exchange com o endereço SIP exumsa4@fabrikam.com como Verdadeiro. Primeiro chamamos o objeto Get-CsExUmContact para recuperar o objeto de contato (também poderíamos ter usado o nome de exibição do contato no Active Directory, o nome principal do usuário do contato ou o nome de logon do contato.) Este comando recupera um contato com a Identidade fornecida. Este contato será então passado ao cmdlet Set-CsExUmContact, no qual definimos o parâmetro AutoAttendant como Verdadeiro.

-------------------------- Exemplo 2 --------------------------

Set-CsExUmContact -Identity "CN={1bf6208d-2847-45d0-828f-636f14da858b},OU=ExUmContacts,DC=litwareinc,DC=com" -AutoAttendant $True

Este exemplo é idêntico ao Exemplo 1, mas em vez de recuperar o contato chamando o Get-CsExUmContact e canalizando o objeto para o Set-CsExUmContact, fornecemos o Set-CsExUmContact com a Identidade do contato que queremos modificar. Observe o formato da Identidade: nesse caso, usamos o nome diferenciado completo do objeto de contato, que inclui um GUID gerado automaticamente (gerado no momento em que o contato foi criado). Em seguida, definimos o parâmetro AutoAttendant do contato como Verdadeiro.