Compartilhar via

  • Artigo

Get-CsExUmContact

 

Tópico modificado em: 2012-03-23

Recupera um ou mais objetos de contato hospedados do Unificação de Mensagens (UM) do Exchange.

Sintaxe

Get-CsExUmContact [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

Descrição Detalhada

O Microsoft Lync Server 2010 funciona com o UM do Exchange para fornecer várias capacidades relacionadas com voz, incluindo o Atendente Automático e o Acesso de Assinante. Quando o UM do Exchange é fornecido como um serviço hospedado (e não no local), os objetos de contato devem ser criados usando o Windows PowerShell para aplicar a funcionalidade de Acesso de Assinante e Atendedor Automático. Este cmdlet recupera um ou vários desses contatos.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsExUmContact localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

UserIdParameter

O identificador único do objeto de contato que você deseja recuperar. 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 dos Serviços de Domínio Active Directory do contato (por exemplo, Atendente Automático da Equipe).

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

Filter

Opcional

Cadeia de caracteres

Permite que você limite os dados retornados, filtrando por atributos específicos do Lync Server 2010. Por exemplo, você pode limitar dados devolvidos a contatos que têm a linha URIs que começa com "tel:555".

O parâmetro Filter usa um subconjunto da sintaxe de filtragem do Windows PowerShell usada pelo cmdlet Where-Object. Por exemplo, um filtro que retorne apenas contatos que foram habilitados para o Enterprise Voice poderia se parecer com este: {EnterpriseVoiceEnabled-eq $True}, com EnterpriseVoiceEnabled representando o atributo Active Directory; a representação -eq do operador de comparação (igual a); e $True (um Windows PowerShell interno variável) representando o valor do filtro.

LdapFilter

Opcional

Cadeia de caracteres

Permite que você limite os dados devolvidos filtrando atributos do Active Directory "genéricos" (ou seja, atributos que não são específicos para Lync Server).

O parâmetro LdapFilter usa a linguagem de consulta LDAP ao criar filtros.

Credential

Opcional

PSCredential

Permite executar o cmdlet sob credenciais alternativas; isto poderia ser necessário se a conta que você usou para fazer logon no Windows não tiver os privilégios necessários para trabalhar com objetos de contato.

Para usar o parâmetro Credential, primeiro crie um objeto PSCredential chamando o cmdlet Get-Credential.

DomainController

Opcional

Fqdn

Permite que você conecte a um controlador de domínio especificado para recuperar as informações de contato. Para conectar a um determinado controlador de domínio, inclua o parâmetro DomainController seguido pelo nome de computador (por exemplo, atl-mcs-001) ou o seu nome de domínio totalmente qualificado (por exemplo, atl-mcs-001.litwareinc.com).

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

OU

Opcional

OUIdParameter

Permite limitar as informações recuperada a uma OU (unidade organizacional) do Active Directory específica. Observe que isto retorna os dados do OU especificado e qualquer OUs filho.

Especificando um OU, use o nome diferenciado daquele container; por exemplo, OU=ExUmContacts,dc=litwareinc,dc=com.

ResultSize

Opcional

Inteiro

Permite limitar o número de registros devolvidos por um comando. Por exemplo, para retornar somente sete contatos (independentemente de quantos contatos estão na sua floresta), basta incluir o parâmetro ResultSize e definir o valor de parâmetro como 7. Observe que não há como garantir que sete contatos serão retornados. se você estabelecer o ResultSize como 7, mas você tiver só três contatos na sua floresta, o comando devolverá aqueles três contatos e, em seguida, concluirá sem erro.

O tamanho do resultado pode ser definido em qualquer número inteiro entre 0 e 2147483647, inclusive. Se definir como 0 o comando executará, mas nenhum dado será devolvido.

Tipo de dados completos: Microsoft.Rtc.Management.ADConnect.Core.Unlimited

Tipos de Entrada

Cadeia de caracteres. Aceita um valor de cadeia de caracteres em pipeline representando o parâmetro Identity de um objeto de contato do UM do Exchange.

Tipos de Retorno

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

Exemplo

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

Get-CsExUmContact

Este exemplo recupera todos os contatos UM do Exchange definidos dentro de uma implantação Lync Server 2010.

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

Get-CsExUmContact -Identity sip:exum1@fabrikam.com

Este exemplo recupera o contato UM do Exchange com o endereço SIP sip:exum1@fabrikam.com

-------------------------- Exemplo 3 --------------------------

Get-CsExUmContact -Filter {Enabled -eq $False}

Neste exemplo, usamos o parâmetro com Filtro para recuperar todos os contatos UM do Exchange que não são habilitados para o Lync Server 2010. Fazemos isto filtrando na propriedade Enabled para verificar se o valor desta propriedade é igual a (-eq) False ($False). Os contatos devolvidos por este comando não funcionarão.

-------------------------- Exemplo 4 --------------------------

Get-CsExUmContact -Filter {LineURI -like "tel:555*"}

Este comando filtra na propriedade LineURI para recuperar todos os contatos UM do Exchange com um LineURI que começam com 555. Em outras palavras, ele recupera todos os contatos com um número de telefone que começa com 555.

-------------------------- Exemplo 5 --------------------------

Get-CsExUmContact -OU "OU=ExUmContacts,DC=Vdomain,DC=com"

Este comando neste exemplo usa o parâmetro OU para recuperar todos os contatos UM do Exchange que estão no Active Directory OU OU=ExUmContacts,DC=Vdomain,DC=com.