Compartilhar via

  • Artigo

Remove-CsTrustedApplicationEndpoint

 

Tópico modificado em: 2012-03-26

Remove um ponto de extremidade de aplicativo confiável.

Sintaxe

Remove-CsTrustedApplicationEndpoint -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-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. Esse cmdlet remove do Serviços de Domínio Active Directory (AD DS) um objeto de contato existente de ponto de extremidade.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsTrustedApplicationEndpoint localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

UserIdParameter

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

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.ADConnect.Schema.OCSADApplicationContact. Aceita entrada canalizada dos objetos de ponto de extremidade do aplicativo confiável.

Tipos de Retorno

Este cmdlet não retorna um valor. Remove um objeto do tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Exemplo

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

Remove-CsTrustedApplicationEndpoint -Identity "Endpoint 1"

Esse exemplo remove o contato do ponto de extremidade cuja Identidade (nesse caso o nome de exibição) for Endpoint 1. Como as identidades devem ser exclusivas, esse comando removerá, no máximo, um ponto de extremidade.

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

Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Remove-CsTrustedApplicationEndpoint

Esse exemplo remove todos os pontos de extremidade do aplicativo confiável que estiverem associados ao aplicativo tapp2. Isto é realizado chamando-se primeiramente Get-CsTrustedApplicationEndpoint e passando-se o ID tapp2 ao parâmetro ApplicationId. Isso retornará uma coleção de pontos de extremidade associados ao aplicativo confiável tapp2. Essa coleção será então canalizada para o cmdlet Remove-CsTrustedApplicationEndpoint, que removerá cada ponto de extremidade na coleção. Lembre-se de que essa chamada para Get-CsTrustedApplicationEndpoint pode recuperar pontos de extremidade com o ID de aplicativo tapp2 de diversos pools, o que resultaria na remoção, por parte desse comando, de pontos de extremidade de aplicativos confiáveis de diversos pools.