Partager via

  • Article

Get-CsTrustedApplicationEndpoint

 

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

Extrait des informations sur un ou plusieurs systèmes d’extrémité d’application approuvée.

Syntaxe

Get-CsTrustedApplicationEndpoint [-Identity <UserIdParameter>] [-ApplicationId <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-TrustedApplicationPoolFqdn <String>]

Description détaillée

Le système d’extrémité d’une application approuvée est un objet contact Active Directory qui permet d’acheminer des appels vers une application approuvée. Cette cmdlet extrait un ou plusieurs objets de contact de système d’extrémité existants dans les 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 Get-CsTrustedApplicationEndpoint : RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsTrustedApplicationEndpoint"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Paramètre ID utilisateur

Identité (nom unique), adresse SIP ou nom complet du système d’extrémité d’application à modifier.

Filter

Facultatif

Chaîne

Permet de limiter les données retournées en filtrant des attributs spécifiques pour Microsoft Lync Server 2010. Par exemple, vous pouvez limiter les données retournées aux contacts dont les noms complets ou les adresses SIP correspondent à un modèle générique.

Le paramètre Filter utilise la même syntaxe de filtrage Windows PowerShell que celle employée par la cmdlet Where-Object. Par exemple, un filtre qui retourne uniquement les contacts qui ont été activés pour Enterprise Voice se présente comme suit : {EnterpriseVoiceEnabled -eq $True}, où EnterpriseVoiceEnabled correspond à l’attribut Active Directory, -eq correspond à l’opérateur de comparaison (égal à) et $True (variable Windows PowerShell intégrée) correspond à la valeur de filtre.

ApplicationId

Facultatif

Chaîne

ID de l’application approuvée pour le système d’extrémité que vous souhaitez récupérer.

Credential

Facultatif

Objet Credential PS

Autres informations à utiliser pour récupérer le système d’extrémité. Vous pouvez extraire un objet PSCredential en appelant la cmdlet Get-Credential.

DomainController

Facultatif

FQDN

Permet de spécifier un contrôleur de domaine. Si aucun contrôleur de domaine n’est spécifié, c’est le premier contrôleur disponible qui sera utilisé.

OU

Facultatif

OUIdParameter

Unité d’organisation dans laquelle réside le système d’extrémité.

ResultSize

Facultatif

Illimité

Nombre maximal de systèmes d’extrémité à récupérer.

TrustedApplicationPoolFqdn

Facultatif

Chaîne

Nom de domaine complet (FQDN) du pool d’applications approuvées associé à l’application pour le système d’extrémité que vous souhaitez récupérer.

Types d’entrées

Chaîne. Accepte une valeur de chaîne redirigée représentant l’identité d’un compte d’utilisateur.

Types de retours

Extrait un objet de type Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Exemple

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

Get-CsTrustedApplicationEndpoint

Cet exemple récupère des informations sur toutes les applications approuvées définies dans le déploiement Lync Server 2010.

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

Get-CsTrustedApplicationEndpoint -Identity "sip:endpoint1@litwareinc.com"

L’exemple 2 récupére des informations sur le contact du système d’extrémité d’application dont l’adresse SIP est endpoint1@litwareinc.com. Notez que le préfixe sip: est nécessaire lorsque vous utilisez l’adresse SIP comme identité.

-------------------------- Exemple 3 ------------------------

Get-CsTrustedApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}

L’exemple 3 récupère tous les systèmes d’extrémité d’application approuvée qui disposent de la chaîne « endpoint » dans leur nom complet. Pour ce faire, la commande utilise le paramètre Filter. La valeur du paramètre permet de rechercher les objets de système d’extrémité dont le nom complet (DisplayName) contient (-like) la chaîne endpoint (*endpoint* - les caractères génériques indiquent que n’importe quels caractères peuvent se trouver avant ou après la chaîne endpoint, ce qui implique que endpoint peut se trouver n’importe où dans le nom complet).

-------------------------- Exemple 4 ------------------------

Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Select-Object SipAddress, DisplayName, OwnerUrn

L’exemple 4 retourne tous les systèmes d’extrémité d’application approuvée qui sont associés à l’application tapp2. Cette opération est exécutée en envoyant l’ID tapp2 au paramètre ApplicationId. Notez qu’aucun nom de domaine complet de pool n’est fourni. Cela implique que si une application avec l’ID tapp2 existe dans plusieurs pools, les systèmes d’extrémité de toutes ces applications sont extraits. La partie suivante de cette commande redirige l’objet ou les objets retournés vers la cmdlet Select-Object qui affiche uniquement les propriétés SipAddress, DisplayName et OwnerUrn de ces objets.