Get-CsApplicationEndpoint
Dernière rubrique modifiée : 2012-03-23
Extrait les systèmes d’extrémités pour le service d’application.
Syntaxe
Get-CsApplicationEndpoint [-Identity <UserIdParameter>] [-ApplicationId <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-PoolFqdn <String>] [-ResultSize <Unlimited>]
Description détaillée
La cmdlet extrait un ou plusieurs contacts d’application des services de domaine Active Directory (AD DS). Ces objets sont stockés dans Active Directory dans le conteneur Contacts d’application du service RTC.
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-CsApplicationEndpoint : 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-CsApplicationEndpoint"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Paramètre ID utilisateur |
Identité, adresse SIP ou nom complet du système d’extrémité d’application à supprimer. L’identité est constituée du nom unique du point de terminaison. Il contient généralement un identificateur global unique (GUID) dans le nom commun, par exemple : CN={8811fefe-e0bb-4fab-ae39-7aaeddd423dc},CN=Application Contacts,CN=RTC Service,CN=Services,CN=Configuration,DC=Vdomain,DC=com. |
ApplicationId |
Facultatif |
Chaîne |
ID du système d’extrémité d’application à extraire. L’ID d’application est la valeur de la propriété OwnerUrn du point de terminaison. Par exemple, si la propriété OwnerUrn a la valeur urn:application:Caa, l’ID d’application est urn:application:Caa. Toutefois, vous pouvez entrer uniquement le suffixe, Caa, en l’occurrence, pour extraire le système d’extrémité. Par exemple : -ApplicationId Caa. |
Credential |
Facultatif |
PSCredential |
Informations d’identification secondaires qu’utilise l’opération Get. Vous pouvez extraire un objet PSCredential en appelant la cmdlet Windows PowerShellGet-Credential. |
DomainController |
Facultatif |
FQDN |
Permet de spécifier un contrôleur de domaine. Si aucun contrôleur de domaine n’est spécifié, le système utilisera le premier disponible. |
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. |
OU |
Facultatif |
OUIdParameter |
Unité d’organisation (OU) sur laquelle réside le système d’extrémité. |
PoolFqdn |
Facultatif |
Chaîne |
Nom de domaine complet du pool où se trouve le point de terminaison d’application. |
ResultSize |
Facultatif |
Illimité |
Nombre maximal d’enregistrements de point de terminaison à extraire. |
Types d’entrées
Chaîne. Accepte une valeur de chaîne transmise par pipeline représentant l’identité du système d’extrémité.
Types de retours
Extrait un objet de type Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsApplicationEndpoint
Cet exemple extrait des informations sur tous les points de terminaison définis dans le déploiement Lync Server 2010.
-------------------------- Exemple 2 --------------------------
Get-CsApplicationEndpoint -Identity "Call Park Service Contact"
L’exemple 2 extrait des informations sur le contact du système d’extrémité d’application avec le nom complet "Call Park Service Contact".
-------------------------- Exemple 3 --------------------------
Get-CsApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}
L’exemple 3 extrait tous les points de terminaison dont le nom complet contient la chaîne « endpoint ». Pour ce faire, la commande utilise le paramètre Filter. La valeur du paramètre permet de rechercher les objets Point de terminaison 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-CsApplicationEndpoint -ApplicationId tapp2 | Select-Object Identity, SipAddress, DisplayName, OwnerUrn
L’exemple 4 retourne tous les points de terminaison associés à l’application urn: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 points de terminaison de toutes ces applications sont extraits. La partie suivante de cette commande envoie l’objet ou les objets retournés à la cmdlet Select-Object qui affiche uniquement les propriétés Identity, SipAddress, DisplayName et OwnerUrn de ces objets.