Compartilhar via

  • Artigo

New-CsTrustedApplicationEndpoint

 

Tópico modificado em: 2012-03-25

Cria um novo contato de ponto de extremidade para um aplicativo confiável.

Sintaxe

New-CsTrustedApplicationEndpoint -ApplicationId <String> -TrustedApplicationPoolFqdn <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

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. Este cmdlet cria um novo objeto de contato de ponto de extremidade no Serviços de Domínio Active Directory (AD DS) para um aplicativo especificado.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

ApplicationId

Obrigatório

Cadeia de caracteres

O ID de aplicativo do aplicativo confiável para o qual o contato de ponto de extremidade está sendo criado. Já deve existir um aplicativo com este ID. Observe que é possível incluir apenas a parte do nome do ID de aplicativo, não sendo necessária (mas possível) a inclusão das informações de prefixo. Por exemplo, se o ID de aplicativo for urn:application:TrustedApp1, será necessário apenas passar a cadeia de caracteres TrustedApp1 para este parâmetro.

TrustedApplicationPoolFqdn

Obrigatório

Fqdn

O nome de domínio totalmente qualificado (FQDN) do pool de aplicativos confiáveis associado ao aplicativo. É necessário que o aplicativo já esteja associado a este pool, para que o ponto de extremidade seja criado.

SipAddress

Opcional

Cadeia de caracteres

Um endereço SIP do novo objeto de contato. Caso não se inclua o valor deste parâmetro, o endereço SIP será gerado automaticamente no formato sip:RtcApplication-<GUID>.<domain>. Por exemplo: sip:RtcApplication-fbf9e2d1-c6aa-45a3-a045-b92d4ef961b2@litwareinc.com. O domínio será o domínio SIP padrão.

DisplayName

Opcional

Cadeia de caracteres

O nome de exibição do objeto de contato do ponto de extremidade.

DisplayNumber

Opcional

Cadeia de caracteres

O número de telefone do contato, como consta do Catálogo de Endereços.

LineURI

Opcional

Cadeia de caracteres

O número de telefone do contato. Deve estar no formato TEL:<número>. Por exemplo: TEL:+14255551212.

PrimaryLanguage

Opcional

Int32

O idioma principal usado no aplicativo confiável. O idioma deve ser configurado usando um código de idioma válido, como en-US (inglês dos EUA), fr-FR (francês), etc.

SecondaryLanguages

Opcional

Int32[]

Uma coleção de idiomas que também pode ser usada para aplicativos confiáveis. Os valores devem ser configurados como uma lista de valores de códigos de idioma, separados por vírgulas. Por exemplo: a seguinte sintaxe define francês canadense e francês como idiomas secundários: -SecondaryLanguages "fr-CA","fr-FR".

Tenant

Opcional

GUID

O identificador globalmente exclusivo (GUID) do objeto. Este parâmetro não é utilizado para implantações locais.

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.OCSADApplicationContact.

Exemplo

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

New-CsTrustedApplicationEndpoint -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com

Este exemplo cria um ponto de extremidade de aplicativo confiável para o aplicativo com o ID de aplicativo tapp1, hospedado no pool TrustPool.litwareinc.com. ApplicationID e TrustedApplicationPoolFqdn são os únicos parâmetros obrigatórios para se criar um ponto de extremidade de aplicativo confiável. Contudo, tenha em mente que a atribuição de valores somente a esses dois parâmetros irá gerar automaticamente um endereço SIP para o contato. Para garantir que o endereço SIP seja exclusivo, o endereço gerado automaticamente incluirá um identificador globalmente exclusivo (GUID) e terá uma aparência semelhante a esta: sip:RtcApplication-fbf9e2d1-c6aa-45a3-a045-b92d4ef961b2@litwareinc.com. Caso prefira um exemplo mais fácil de ler, consulte o Exemplo 2.

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

New-CsTrustedApplicationEndpoint -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -SipAddress sip:endpoint1@litwareinc.com

O Exemplo 2 é idêntico ao Exemplo 1, pelo fato de que ele cria um ponto de extremidade de aplicativo confiável para o aplicativo com ID tapp1 no pool TrustPool.litwareinc.com. Mas diferentemente do Exemplo 2, incluiu-se um parâmetro a mais na criação do ponto de extremidade: SipAddress. Em vez de permitir que o sistema gere um endereço SIP, especificou-se um endereço de endpoint1@litwareinc.com.