Condividi tramite

  • Articolo

Remove-CsTrustedApplicationEndpoint

 

Ultima modifica dell'argomento: 2012-03-26

Rimuove l'endpoint di un'applicazione attendibile.

Sintassi

Remove-CsTrustedApplicationEndpoint -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

L'endpoint applicazione attendibile è un oggetto contatto di Active Directory che consente il routing delle chiamate verso un'applicazione attendibile. Questo cmdlet rimuove da Servizi di dominio Active Directory un oggetto contatto dell'endpoint esistente.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsTrustedApplicationEndpoint i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

UserIDParameter

Identità (nome distinto del contatto), indirizzo SIP o nome visualizzato dell'endpoint applicazione da rimuovere.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Oggetto Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact. Accetta l'input da pipeline di oggetti endpoint applicazione attendibile.

Tipi restituiti

Questo cmdlet non restituisce un valore. Rimuove un oggetto di tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Esempio

-------------------------- Esempio 1 ------------------------

Remove-CsTrustedApplicationEndpoint -Identity "Endpoint 1"

L'esempio mostra la rimozione del contatto dell'endpoint con identità (in questo caso il nome visualizzato) Endpoint 1. Poiché le identità devono essere univoche, il comando rimuoverà al massimo un endpoint.

-------------------------- Esempio 2 ------------------------

Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Remove-CsTrustedApplicationEndpoint

In questo esempio vengono rimossi tutti gli endpoint delle applicazioni attendibili associati all'applicazione tapp2. È possibile eseguire questa operazione chiamando innanzitutto Get-CsTrustedApplicationEndpoint e passando l'ID tapp2 al parametro ApplicationId. Questa operazione restituirà una raccolta di endpoint associati all'applicazione attendibile tapp2. La raccolta viene quindi inviata tramite pipe al cmdlet Remove-CsTrustedApplicationEndpoint, che rimuove ogni endpoint della raccolta. Considerare che con questa chiamata a Get-CsTrustedApplicationEndpoint è possibile che vengano recuperati gli endpoint con ID applicazione tapp2 da più pool, con la conseguente rimozione di endpoint applicazione attendibile da più pool.