Get-CsCallParkOrbit
Dernière rubrique modifiée : 2012-03-23
Récupère les paramètres de la plage des orbites de mise en garde d’appels de l’organisation.
Syntaxe
Get-CsCallParkOrbit [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsCallParkOrbit [-Filter <String>] [-LocalStore <SwitchParameter>]
Description détaillée
Cette cmdlet récupère les paramètres des orbites de parcage d’appel définies pour une organisation. Vous pouvez soit récupérer une seule plage des orbites de mise en garde d’appels (spécifiée par le paramètre Identity) ou vous pouvez appeler Get-CsCallParkOrbit sans paramètre afin de récupérer toutes les plages des orbites de mise en garde d’appels définies pour une organisation. Les orbites de mise en garde d’appels sont composées de paramètres qui spécifient une plage de numéros dans laquelle un utilisateur peut mettre un appel en garde, ainsi que les serveurs associés à ces plages de numéros.
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-CsCallParkOrbit : RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmin. 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-CsCallParkOrbit"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Chaîne |
Nom unique de la plage des orbites de mise en garde d’appels. Ce nom a été attribué par l’administrateur lors de la définition de la plage des orbites de mise en garde d’appels. |
Filter |
Facultatif |
Chaîne |
Ce paramètre accepte une chaîne à caractères génériques et retourne toutes les plages des orbites de mise en garde d’appels dont les identités correspondent à cette chaîne. Par exemple, une valeur Filter de Redmond* retournera toutes les plages des orbites de mise en garde d’appels dont les noms commencent par la chaîne Redmond, comme Redmond 1, Redmond 2, RedmondCPO, etc. |
LocalStore |
Facultatif |
GUID |
Extrait les informations sur les orbites de mise en garde d’appels du réplica local de la magasin central de gestion et non de la magasin central de gestion proprement dite. |
Types d’entrées
Aucun.
Types de retours
Cette cmdlet retourne un objet de type Microsoft.Rtc.Management.Voice.Helpers.DisplayCallParkOrbits.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsCallParkOrbit
Dans cet exemple, on appelle Get-CsCallParkOrbit sans spécifier de paramètres supplémentaires. Cet appel à Get-CsCallParkOrbit retourne une collection de toutes les plages des orbites de mise en garde d’appels configurées pour être utilisées dans votre organisation.
-------------------------- Exemple 2 --------------------------
Get-CsCallParkOrbit -Identity "Redmond CPO 1"
Dans l’exemple précédent, Get-CsCallParkOrbit permet de retourner les informations relatives à la plage des orbites de mise en garde d’appels dont le nom est « Redmond CPO 1 ».
-------------------------- Exemple 3 --------------------------
Get-CsCallParkOrbit -Filter *Redmond*
La commande de cet exemple retourne toutes les plages des orbites de mise en garde d’appels qui contiennent la chaîne « Redmond » dans leur identité. Par exemple, cette commande renverra les orbites de parcage d’appel dont les identités sont notamment « Redmond 501 », « CP Redmond 1 » et « ARedmond ». La commande utilise le paramètre Filter avec le caractère générique (*) pour désigner le contenu à rechercher. (Cette recherche n’est pas sensible à la casse.)
-------------------------- Exemple 4 --------------------------
Get-CsCallParkOrbit | Where-Object {$_.CallParkServiceId.toString() -eq "ApplicationServer:pool0.litwareinc.com"}
Cette commande retourne toutes les plages des orbites de mise en garde d’appels affectées au service de mise en garde d’appels dont l’ID est ApplicationServer:pool0.litwareinc.com. La cmdlet Get-CsCallParkOrbit récupère une collection de toutes les plages des orbites de mise en garde d’appels pour la rediriger vers la cmdlet Where-Object. Cet appel à Where-Object recherche dans cette collection toutes les orbites de mise en garde d’appels dont les propriétés CallParkServiceId contiennent la valeur ApplicationServer:pool0.litwareinc.com. Notez que nous ajoutons la méthode toString à la fin du nom du paramètre CallParkServiceId. CallParkServiceId est de type WritableServiceId. Afin de comparer cette valeur à la chaîne fournie, nous devons d’abord la transformer en une chaîne en appelant la méthode toString.
-------------------------- Exemple 5 --------------------------
Get-CsCallParkOrbit | Where-Object {$_.NumberRangeStart.StartsWith("*")}
La commande de cet exemple retourne toutes les plages des orbites de mise en garde d’appels dans lesquelles la série de numéros commence par un préfixe *. Une fois que Get-CsCallParkOrbit a récupéré une collection de toutes les plages des orbites de mise en garde d’appels, la collection est redirigée vers Where-Object. Where-Object restreint la collection aux plages des orbites de mise en garde d’appels dont l’emplacement de mise en garde d’appels commence par *. Pour ce faire, elle contrôle la propriété StartsWith de l’objet NumberRangeStart pour la chaîne « * ».
-------------------------- Exemple 6 --------------------------
Get-CsCallParkOrbit | Where-Object {[Char]::IsDigit($_.NumberRangeStart[0])}
La commande de cet exemple retourne toutes les plages des orbites de mise en garde d’appels pour lesquelles aucun préfixe n’a été affecté à leurs numéros. (Un préfixe correspond à la valeur * ou # placée au début du numéro.) Toutes les orbites de parcage d’appels renvoyées par cette commande n’auront que des numéros sans autre caractère. Get-CsCallParkOrbit récupère une collection de toutes les plages des orbites de mise en garde d’appels, puis cette collection est redirigée vers Where-Object. Si on analyse le critère contenu dans l’appel à Where-Object, nous avons ce qui suit : $_.NumberRangeStart[0]). Il retourne le premier caractère contenu dans le numéro, au début de la série. (Notez que nous ne devons vérifier que le début de la plage. Si le premier numéro ne comporte pas de préfixe, la fin n’en comportera pas non plus.) Ce caractère est transmis à la fonction IsDigit qui détermine s’il s’agit d’un caractère numérique. Si c’est le cas, les informations d’orbite de parcage d’appel relatives à l’élément de la collection correspondante seront bien renvoyées.