Get-CsPstnUsage
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les enregistrements de l’utilisation du réseau téléphonique commuté (RTC) utilisés au sein de votre organisation.
Syntaxe
Get-CsPstnUsage [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPstnUsage [-Filter <String>] [-LocalStore <SwitchParameter>]
Description détaillée
Les utilisations du réseau téléphonique commuté sont des valeurs de chaîne utilisées pour l’autorisation d’appel. Une utilisation du réseau téléphonique commuté lie une stratégie de voix à un itinéraire. La cmdlet Get-CsPstnUsage récupère la liste de toutes les utilisations du réseau téléphonique commuté disponibles dans votre organisation.
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-CsPstnUsage : RTCUniversalUserAdmins, 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 "Get-CsPstnUsage"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Niveau auquel ces paramètres sont appliqués. La seule identité applicable aux utilisations du réseau téléphonique commuté est Global. |
Filter |
Facultatif |
Chaîne |
Le paramètre Filter vous permet uniquement d’extraire les utilisations du réseau téléphonique commuté dont l’identité correspond à une chaîne à caractère générique donnée. Néanmoins, la seule identité disponible pour les utilisations du réseau téléphonique commuté est Global. Ce paramètre n’a donc aucune utilité pour cette cmdlet. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Récupère les informations d’utilisation du réseau téléphonique commuté à partir du magasin de données local au lieu du magasin central de gestion. |
Types d’entrées
Aucun.
Types de retours
Get-CsPstnUsage retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PSTNUsages.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsPstnUsage
Cette commande renvoie la liste des utilisations du réseau téléphonique commuté globales disponibles dans votre organisation.
-------------------------- Exemple 2 --------------------------
(Get-CsPstnUsage).Usage
La commande affichée dans cet exemple renvoie une liste de toutes les utilisations définies du réseau téléphonique commuté, avec une seule utilisation répertoriée sur chaque ligne du résultat produit. L’appel de Get-CsPstnUsage renvoie l’identité et la liste des utilisations. Si la liste des utilisations contient plus de trois ou quatre entrées, elle sera abrégée de la manière suivante dans la sortie :
Utilisation : {Internal, Local, Long Distance, International...}
Utilisez la commande de cet exemple pour afficher uniquement une liste des utilisations. Le résultat sera similaire à ceci :
Internal
Local
Long Distance
International
Restricted
-------------------------- Exemple 3 --------------------------
(Get-CsPstnUsage).Usage | ForEach-Object {if ($_ -like "*tern*") {$_}}
Cette commande retourne tous les noms des utilisations du réseau téléphonique commuté qui contiennent la chaîne tern. Par exemple, cette commande renverra les utilisations « Internal » et « International » mais pas l’utilisation « Local » ou « Long Distance ».
La première partie de la commande est la cmdlet Get-CsPstnUsage entre parenthèses, ce qui signifie que la première opération réalisée est la récupération de l’ensemble des utilisations du réseau téléphonique commuté. La propriété .Usage renvoie uniquement les informations des utilisations du réseau téléphonique commuté et non l’identité. Cette liste d’utilisations est ensuite redirigée vers la cmdlet ForEach-Object qui examine une à une les chaînes d’utilisation. L’instruction If compare la chaîne d’utilisation actuelle à la chaîne *tern* (les * sont des caractères génériques) et affiche toutes les occurrences conformes à ce modèle.