Compartilhar via

  • Artigo

Get-CsTrustedApplicationEndpoint

 

Tópico modificado em: 2012-03-23

Recupera informações sobre um ou mais pontos de extremidade de aplicativos confiáveis.

Sintaxe

Get-CsTrustedApplicationEndpoint [-Identity <UserIdParameter>] [-ApplicationId <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-TrustedApplicationPoolFqdn <String>]

Descrição Detalhada

Um ponto de extremidade de aplicativo confiável é um objeto de contato do Active Directory que permite o roteamento de chamadas para um aplicativo confiável. Esse cmdlet recupera um ou mais objetos de contato de ponto de extremidade existentes no Serviços de Domínio Active Directory (AD DS).

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsTrustedApplicationEndpoint localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. 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 "Get-CsTrustedApplicationEndpoint"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

UserIdParameter

A identidade (o nome diferenciado), o endereço SIP ou o nome de exibição do ponto de extremidade do aplicativo a ser modificado.

Filter

Opcional

Cadeia de caracteres

Permite limitar os dados retornados pela filtragem de atributos específicos a Microsoft Lync Server 2010. Por exemplo, é possível limitar os dados retornados aos contatos cujos nomes para exibição ou endereços SIP corresponderem a um determinado padrão de caracteres curinga.

O parâmetro Filter usa a mesma sintaxe de filtragem do Windows PowerShell utilizada pelo cmdlet Where-Object. Por exemplo: um filtro que retorna apenas contatos que tiverem sido habilitados para o Enterprise Voice poderia ter a seguinte aparência: {EnterpriseVoiceEnabled-eq $True}, onde EnterpriseVoiceEnabled representa o atributo do Active Directory; -eq, o operador de comparação (igual a) e $True (uma variável interna do Windows PowerShell), o valor do filtro.

ApplicationId

Opcional

Cadeia de caracteres

O ID do aplicativo confiável do ponto de extremidade que se deseja recuperar.

Credential

Opcional

PSCredential

Credenciais alternativas a serem utilizadas para recuperar o ponto de extremidade. É possível recuperar um objeto PSCredential chamando o cmdlet Get-Credential.

DomainController

Opcional

Fqdn

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

OU

Opcional

OUIdParameter

O OU no qual reside o ponto de extremidade.

ResultSize

Opcional

Ilimitado

O número máximo de registros de ponto de extremidade a recuperar.

TrustedApplicationPoolFqdn

Opcional

Cadeia de caracteres

O FQDN do pool de aplicativos confiáveis associado ao aplicativo do ponto de extremidade que se deseja recuperar.

Tipos de Entrada

Cadeia de caracteres. Aceita um valor canalizado de cadeia de caracteres, que representa a Identidade de uma conta de usuário.

Tipos de Retorno

Recupera um objeto do tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Exemplo

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

Get-CsTrustedApplicationEndpoint

Este exemplo recupera informações sobre todos os pontos de extremidade de aplicativos confiáveis definidos na implantação do Lync Server 2010.

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

Get-CsTrustedApplicationEndpoint -Identity "sip:endpoint1@litwareinc.com"

O Exemplo 2 recupera informações sobre o contato do ponto de extremidade do aplicativo com o endereço SIP endpoint1@litwareinc.com. Observe que o prefixo sip: é necessário ao se utilizar um endereço SIP como Identidade.

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

Get-CsTrustedApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}

O Exemplo 3 recupera todos os pontos de extremidade de aplicativos confiáveis que contiverem a cadeia de caracteres "ponto de extremidade" em qualquer posição do seu nome para exibição. Para tal, o comando utiliza o parâmetro Filter. O valor dos filtros de parâmetro para localizar os objetos de ponto de extremidade que tiverem um nome de exibição (DisplayName) que contenha (-like) a cadeia de caracteres de ponto de extremidade (*ponto de extremidade* - os caracteres curinga indicam que quaisquer caracteres podem vir antes ou após o ponto de extremidade da cadeia de caracteres, ou seja, o ponto de extremidade pode estar em qualquer posição do nome para exibição).

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

Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Select-Object SipAddress, DisplayName, OwnerUrn

O Exemplo 4 retornará todos os pontos de extremidade de aplicativos confiáveis associados ao aplicativo tapp2. Isto é obtido passando-se o ID tapp2 ao parâmetro ApplicationId. Observe que não foi fornecido um pool FQDN; isto significa que se um aplicativo com o ID tapp2 existir em mais de um pool, serão recuperados os pontos de extremidade correspondentes a todos os aplicativos. A próxima parte desse comando canalizará o objeto ou objetos retornados ao cmdlet Select-Object, que exibirá apenas as propriedades SipAddress, DisplayName e OwnerUrn destes objetos.