Compartilhar via

  • Artigo

New-CsExUmContact

 

Tópico modificado em: 2012-03-25

Cria um novo objeto de contato Atendedor Automático ou Acesso de Assinante para o Unificação de Mensagens (UM) do Exchange hospedado.

Sintaxe

New-CsExUmContact -DisplayNumber <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> -SipAddress <String> [-AutoAttendant <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Microsoft Lync Server 2010 funciona em conjunto 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 é fornecido como um serviço hospedado (e não em uma implementação local), os objetos de contato devem ser criados com este cmdlet para aplicar a funcionalidade do Atendedor Automático e do Acesso de Assinante. Estes objetos são criados chamando-se o cmdlet New-CsExUmContact.

Um objeto de contato criado com este cmdlet não estará disponível para uso no sistema enquanto não tiver sido aplicada uma política de correio de voz hospedada que configure o roteamento do contato. É possível recuperar as políticas de correio de voz hospedadas chamando-se o cmdlet Get-CsHostedVoicemailPolicy. Através da política recuperada pode-se determinar se existe uma política global ou de site apropriada, ou se existe uma política por usuário que precise ser concedida a este contato.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsExUmContact localmente: RTCUniversalUserAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

SipAddress

Obrigatório

Cadeia de caracteres

O endereço SIP do contato. Este deve ser um novo endereço, que ainda não exista como um usuário ou contato no Serviços de Domínio Active Directory (AD DS). Este valor deve começar com a cadeia de caracteres sip:, seguida pelo endereço SIP.

RegistrarPool

Obrigatório

Fqdn

O nome de domínio totalmente qualificado (FQDN) do pool no qual estiver sendo executado o serviço Registrador.

Observe que um contato do UM do Exchange no Lync Server 2010 não pode ser transferido para pools que fizerem parte da implantação do Microsoft Office Communications Server 2007 ou do Microsoft Office Communications Server 2007 R2.

Tipo de dados completos: Microsoft.Rtc.Management.Deploy.Fqdn

DisplayNumber

Obrigatório

Cadeia de caracteres

O número de telefone do contato. Os números de exibição de cada contato devem ser exclusivos (por exemplo, não pode haver dois contatos do UM do Exchange com o mesmo número de exibição).

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

OU

Obrigatório

OUIdParameter

A unidade organizacional (OU) em que esse contato estará localizado no Active Directory.

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

AutoAttendant

Opcional

Booleano

Especifica se este objeto de contato é um Atendedor Automático (o Atendedor Automático oferece um conjunto de prompts de voz, que permite aos chamadores navegar no sistema telefônico e conseguir efetuar o contato com a pessoa pretendida).

Padrão: False

Description

Opcional

Cadeia de caracteres

Uma descrição deste contato. A descrição é para uso de administradores, para identificar o tipo do 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.

PassThru

Opcional

SwitchParameter

Retorna os resultados deste comando. A execução deste cmdlet exibirá o objeto recém-criado. A inclusão deste parâmetro simplesmente repetirá a saída, tornando redundante o uso deste parâmetro.

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

Nenhuma.

Tipos de Retorno

Cria um objeto do tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.

Exemplo

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

New-CsExUmContact -SipAddress sip:exumsa1@fabrikam.com -RegistrarPool RedmondPool.litwareinc.com -OU "OU=ExUmContacts,DC=litwareinc,DC=com" -DisplayNumber 2065554567

Este exemplo chama o cmdlet New-CsExUmContact, para criar um novo objeto de contato no Active Directory do UM do Exchange. Para criar um novo contato, deve-se fornecer o endereço SIP (neste exemplo, sip:exumsa1@fabrikam.com) do Atendedor Automático ou Acesso de Assinante. Além disso, deve-se fornecer o nome do pool no qual estiver sendo executando o serviço de Registrador Lync Server 2010 (RedmondPool.litwareinc.com), a OU onde estas informações serão armazenadas (OU=ExUmContacts, DC=litwareinc, DC=com) e o número de telefone do Atendedor Automático ou Acesso de Assinante (2065554567). Como não estabelecemos especificamente o parâmetro AutoAttendant, será aplicado o padrão Falso e se assumirá que este objeto de contato será um contato de Acesso de Assinante.

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

New-CsExUmContact -SipAddress sip:exumaa1@fabrikam.com -RegistrarPool RedmondPool.litwareinc.com -OU "OU=ExUmContacts,DC=litwareinc,DC=com" -DisplayNumber 2065559876 -AutoAttendant $True

Este exemplo é semelhante ao Exemplo 1, ao chamar o cmdlet New-CsExUmContact para criar um novo contato UM do Exchange. Novamente, cria-se um novo contato do Atendedor Automático ou Acesso de Assinante, desta vez com o endereço SIP sip:exumaa1@fabrikam.com. Em seguida, fornece-se o nome do pool no qual estiver sendo executando o serviço Registrador do Lync Server 2010 (RedmondPool.litwareinc.com), a OU onde serão armazenadas estas informações (OU=ExUmContacts, DC=litwareinc, DC=com) e o número de telefone do Atendedor Automático ou Acesso de Assinante (2065554567). A diferença neste exemplo é que o parâmetro opcional Atendedor Automático foi definido como True ($True) para mostrar que este objeto é, de fato, um contato de Atendedor Automático.