Compartilhar via

  • Artigo

New-CsTrustedApplication

 

Tópico modificado em: 2012-03-26

Adiciona o aplicativo confiável a um pool.

Sintaxe

New-CsTrustedApplication -ApplicationId <String> -Port <Int32> -TrustedApplicationPoolFqdn <String> [-Confirm [<SwitchParameter>]] [-EnableTcp <SwitchParameter>] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]]

New-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] -Port <Int32> [-Confirm [<SwitchParameter>]] [-EnableTcp <SwitchParameter>] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Um aplicativo confiável é um aplicativo desenvolvido por um terceiro que recebeu o status de confiável para ser executado como parte do Microsoft Lync Server 2010, embora não seja uma parte interna do produto. Este cmdlet adiciona um aplicativo testado a um pool de aplicativos testados e atribui uma porta ao serviço externo que executa o aplicativo.

Os aplicativos confiáveis precisam estar associados a GRUUs (URIs de operador usuário de encaminhamento global), tanto de serviço quanto de computador. Este cmdlet gera automaticamente esses valores com base nos computadores e serviços associados ao pool no qual esse aplicativo está hospedado.

Ao usar esse cmdlet para criar um aplicativo confiável, você deve fornecer valores para o parâmetro Identity ou para os parâmetros ApplicationID e TrustedApplicationPoolFqdn. O parâmetro Identity é o TrustedApplicationPoolFqdn seguido de uma barra (/) e ApplicationID. Por exemplo, TrustPool.litwareinc.com/tapp2, em que TrustPool.litwareinc.com é TrustedApplicationPoolFqdn e tapp2, ApplicationID.

Observe que, ao inserir um ID de aplicativo (como parte do parâmetro Identity ou do parâmetro ApplicationID), você precisa inserir apenas o nome do aplicativo. No entanto, o ID de aplicativo completo terá um prefixo automático com a cadeia de caracteres urn:application:. Por exemplo, se você inserir o valor tapp2 para ApplicationID, esse ID será armazenado como urn:application:tapp2. Da mesma forma, se você inserir uma Identity TrustPool.litwareinc.com/tapp2, ela será armazenada no sistema como TrustPool.litwareinc.com/urn:application:tapp2.

Quando você especifica o valor Port com esse cmdlet, ele não abre a porta. Você deve abrir a porta no firewall do Windows e em eventuais firewalls corporativos para que o aplicativo confiável faça contato com redes externas ao firewall.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

ExternalApplicationIdentity

Um identificador exclusivo do aplicativo confiável no pool. Os valores de identidade devem ser digitados no formato <FQDN do pool>/<ID do aplicativo>, em que FQDN do pool é o nome de domínio totalmente qualificado do pool no qual o aplicativo reside, e ID do aplicativo é o nome do aplicativo. O ID de aplicativo deve ser exclusivo para um determinado pool.

Se inserir uma Identity, você não poderá especificar valores para os parâmetros ApplicationId ou TrustedApplicationPoolFqdn.

ApplicationId

Obrigatório

Cadeia de caracteres

O nome do aplicativo. Ela deve ser uma cadeia de caracteres exclusiva dentro do pool especificado no parâmetro TrustedApplicationPoolFqdn. A cadeia de caracteres não pode conter espaços. Se fornecer um valor para ApplicationId, você também deverá fornecer um valor para o parâmetro TrustedApplicationPoolFqdn. Não é possível especificar ApplicationId e Identity.

Port

Obrigatório

Int32

O número da porta na qual o aplicativo será executado. A porta deve ser exclusiva em um determinado pool. Em outras palavras, nenhum outro aplicativo que usar essa mesma porta poderá ser definido no pool especificado.

TrustedApplicationPoolFqdn

Obrigatório

Cadeia de caracteres

O FQDN do pool de aplicativos confiáveis no qual o aplicativo residirá. Se fornecer um valor para TrustedApplicationPoolFqdn, você também deverá fornecer um valor para ApplicationId, embora não seja possível fornecer um valor para o parâmetro Identity.

EnableTcp

Opcional

SwitchParameter

Especifica que o aplicativo confiável usará o protocolo TCP. Só use esse parâmetro caso o aplicativo confiável não seja um aplicativo do Microsoft Unified Communications Managed API (UCMA). Isso porque aplicativos do UCMA só oferecem suporte ao protocolo MTLS. Se não especificar o parâmetro Force com o parâmetro EnableTcp, você receberá um aviso de confirmação antes do novo aplicativo confiável ser criado.

LegacyApplicationName

Opcional

Cadeia de caracteres

Só use esse parâmetro caso o aplicativo esteja sendo migrado de uma implantação do Microsoft Office Communications Server 2007 R2. O valor deve ser o mesmo do tipo de GRUU da versão do Office Communications Server 2007 R2 do aplicativo para que os dois trabalhem juntos.

Observe que na maioria dos casos, definir o parâmetro ApplicationId como igual ao tipo de GRUU basta para que os aplicativos trabalhem juntos. No entanto, se o tipo de GRUU do aplicativo do Office Communications Server 2007 R2 contiver caracteres inválidos para o ApplicationId, esse valor deverá ser fornecido no parâmetro LegacyApplicationName.

Se você não especificar um valor para o parâmetro, o valor de Application ID será inserido automaticamente (sem o prefixo urn:application: tag:).

Force

Opcional

SwitchParameter

Suprime todos os avisos de confirmação que seriam exibidos antes que as alterações sejam feitas.

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.Xds.DisplayTrustedApplication.

Exemplo

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

New-CsTrustedApplication -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -Port 6000

Este exemplo cria um aplicativo confiável com o ID de Aplicativo tapp1. Usamos o parâmetro TrustedApplicationPoolFqdn para designar o pool de aplicativos confiáveis em que o aplicativo estará, neste caso, o pool com o FQDN TrustPool.litwareinc.com. Também devemos especificar uma porta para o aplicativo; neste exemplo, usamos a porta 6000. Observe que a execução deste cmdlet especificando-se ApplicationId e TrustedApplicationPoolFqdn irá gerar uma Identity que poderá ser usada posteriormente para recuperar, modificar ou remover o aplicativo.

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

New-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6100

Este exemplo cria um aplicativo confiável com a Identity TrustPool.litwareinc.com/tapp2 na Porta 6100. Observe o formato da Identity. Esse valor deve estar no formato <FQDN do pool confiável>/<ID de Aplicativo>.