Partilhar via

  • Artigo

Set-CsTrustedApplication

 

Tópico modificado em: 2012-03-26

Modifica as configurações de um aplicativo confiável.

Sintaxe

Set-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Port <Int32>] [-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 permite a modificação do número da porta que o serviço externo que executa o aplicativo está usando.

Ao usar o cmdlet para modificar um aplicativo confiável, é preciso fornecer um valor para o parâmetro Identity. Identity é o FQDN (nome de domínio totalmente qualificado) do pool no qual o aplicativo está hospedado, seguido por uma barra (/) e pelo ID do aplicativo. Por exemplo, TrustPool.litwareinc.com/tapp2, onde TrustPool.litwareinc.com é o FQDN do pool e tapp2 é o ID do aplicativo. Observe que ao exibir um aplicativo existente chamando Get-CsTrustedApplication, o ID exibido será mais parecido com este: TrustPool.litwareinc.com/urn:application:tapp2. Observe o prefixo urn:application: antes do nome do aplicativo (tapp2). Embora faça parte da Identity, esse prefixo não é obrigatório quando você especifica o valor do parâmetro Identity.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

ExternalApplicationIdentity

O identificador único do aplicativo confiável que será modificado. Os valores de identidade devem ser digitados no formato <FQDN do pool>/<ID do aplicativo>, onde FQDN do pool é o FQDN do pool no qual o aplicativo reside, e ID do aplicativo é o nome do aplicativo.

Port

Opcional

Int32

O número da porta na qual o aplicativo será executado.

Force

Opcional

SwitchParameter

Suprime eventuais avisos de confirmação que seriam exibidos antes da realização das alterações.

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

Objeto Microsoft.Rtc.Management.Xds.DisplayTrustedApplication. Aceita entrada em pipeline de objetos de aplicativos confiáveis.

Tipos de Retorno

Este cmdlet não retorna um valor. Ele modifica um objeto do tipo Microsoft.Rtc.Management.Xds.DisplayTrustedApplication.

Exemplo

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

Set-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6200

Este exemplo modifica a porta do aplicativo confiável com identidade TrustPool.litwareinc.com/tapp2 para a porta 6200. Para isso, a identidade TrustPool.litwareinc.com/tapp2 é passada para o cmdlet Set-CsTrustedApplication. Essa identidade é consiste no nome do pool no qual o aplicativo reside, seguido pelo nome (ou ID) do aplicativo. Em seguida, incluímos o parâmetro Port, dando a ele o valor 6200, para modificá-lo.