Partager via

  • Article

Remove-CsTrustedApplicationEndpoint

 

Dernière rubrique modifiée : 2012-03-26

Supprime un point de terminaison d’application approuvée.

Syntaxe

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

Description détaillée

Un point de terminaison d’application approuvée est un objet de contact Active Directory qui permet le routage des appels vers une application approuvée. Cette cmdlet supprime un objet de contact de point de terminaison existant des services de domaine Active Directory (AD DS).

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Remove-CsTrustedApplicationEndpoint : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d'accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l'invite Windows PowerShell :

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Paramètre ID utilisateur

L'identité (le nom distinctif du contact), l'adresse SIP ou le nom complet du point de terminaison de l'application à supprimer.

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Objet Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact. Accepte la saisie des données transmises via le pipeline pour les objets points de terminaison d'une application approuvée.

Types de retours

Cette cmdlet ne renvoie aucune valeur. Elle supprime un objet de type Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Exemple

-------------------------- Exemple 1 ------------------------

Remove-CsTrustedApplicationEndpoint -Identity "Endpoint 1"

Cet exemple supprime le contact de point de terminaison dont l’identité (dans ce cas, le nom complet) est Endpoint 1. Puisque les identités doivent être uniques, cette commande supprimera au maximum un point de terminaison.

-------------------------- Exemple 2 ------------------------

Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Remove-CsTrustedApplicationEndpoint

Cet exemple supprime tous les points de terminaison d’application approuvée qui sont associés à l’application tapp2. Cette opération s'effectue en appelant d'abord Get-CsTrustedApplicationEndpoint, puis en transmettant l'ID tapp2 au paramètre ApplicationId. Le système retourne alors une collection de points de terminaison associés à l’application approuvée tapp2. Cette collection est ensuite redirigée vers la cmdlet Remove-CsTrustedApplicationEndpoint, qui supprime chaque point de terminaison présent dans la collection. Veuillez noter que cet appel de la cmdlet Get-CsTrustedApplicationEndpoint permet de récupérer des points de terminaison avec l'application ID tapp2 dans de multipes pools, ce qui engendrerait la suppression de points de terminaison d'applications approuvées dans de nombreux pools.