Set-CsPstnUsage
Dernière rubrique modifiée : 2012-03-25
Modifie un ensemble de chaînes qui identifient les utilisations PSTN (réseau téléphonique commuté) autorisées. Cette cmdlet peut être utilisée pour ajouter des utilisations à la liste des utilisations PSTN ou supprimer des utilisations de la liste.
Syntaxe
Set-CsPstnUsage [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Usage <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsPstnUsage [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Usage <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Les utilisations PSTN sont des valeurs de chaîne utilisées pour l’autorisation d’appel. Une utilisation PSTN lie une stratégie de voix à un itinéraire. La cmdlet Set-CsPstnUsage permet d’ajouter des utilisations téléphoniques à la liste des utilisations ou d’en supprimer de celle-ci. Cette liste est globale ; elle peut donc être utilisée à la fois par les stratégies et les itinéraires dans le déploiement Microsoft Lync Server 2010.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-CsPstnUsage : 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 "Set-CsPstnUsage"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Étendue au niveau de laquelle ces paramètres sont appliqués. L’identité de cette cmdlet est toujours l’identité Global. |
Instance |
Facultatif |
PstnUsages |
Référence à un objet d’utilisation PSTN. Cet objet doit être de type PstnUsages et peut être récupéré en appelant la cmdlet Get-CsPstnUsage. |
Usage |
Facultatif |
Modificateur de liste PS |
Contient une liste des chaînes d’utilisations autorisées. Ces entrées peuvent être n’importe quelle valeur de chaîne. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications. |
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.WritableConfig.Policy.Voice.PstnUsages. Accepte la saisie de données transmises via le pipeline pour les objets d’utilisation PSTN.
Types de retours
Cette cmdlet ne retourne ni valeur, ni objet. Au lieu de cela, elle configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnUsages.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsPstnUsage -Identity global -Usage @{add="International"}
Cette commande ajoute la chaîne « International » à la liste actuelle des utilisations PSTN disponibles.
-------------------------- Exemple 2 --------------------------
Set-CsPstnUsage -Identity global -Usage @{remove="Local"}
Cette commande appelle la chaîne « Local » à partir de la liste des utilisations PSTN disponibles.
-------------------------- Exemple 3 --------------------------
Set-CsPstnUsage -Usage @{remove="Local"}
La commande présentée dans cet exemple effectue exactement la même action que dans l’exemple 2 : elle supprime l’utilisation PSTN « Local ». Cette exemple présente la commande sans spécifier de paramètre Identity. La seule identité disponible pour la cmdlet Set-CsPstnUsage est l’identité Global ; si le paramètre Identity est omis, la valeur par défaut est Global.
-------------------------- Exemple 4 --------------------------
Set-CsPstnUsage -Usage @{replace="International","Restricted"}
Cette commande remplace tous les éléments de la liste des utilisations dont les valeurs sont International et Restricted. Toutes les utilisations qui existaient précédemment sont supprimées.