Partager via

  • Article

Get-CsLocationPolicy

 

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

Retourne des informations indiquant comment (ou si) le service d’informations sur l’emplacement Enhanced 9-1-1 (E9-1-1) a été configuré. Le service E9-1-1 permet à des personnes répondant à des appels d'urgence de déterminer la position géographique de l'appelant.

Syntaxe

Get-CsLocationPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsLocationPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Description détaillée

La stratégie d’emplacement est utilisée pour appliquer des paramètres liés à la fonctionnalité E9-1-1. La stratégie d'emplacement détermine si un utilisateur peut avoir recours au système E9-1-1 et, le cas échéant, quel est le comportement d'un appel d'urgence. Par exemple, la stratégie d’emplacement permet de définir le numéro d’appel d’urgence (911 aux États-Unis), si la sécurité de l’entreprise doit être automatiquement avertie, comment l’appel doit être acheminé, etc. Cette cmdlet récupère une ou plusieurs stratégies d’emplacement.

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-CsLocationPolicy : 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-CsLocationPolicy"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la stratégie d’emplacement que vous souhaitez récupérer. Pour récupérer la stratégie d'emplacement globale, utilisez la valeur Global. Pour une stratégie créée au niveau de l'étendue Site, cette valeur prend la forme site:<nom du site>, où le nom du site est celui défini dans le déploiement de Microsoft Lync Server 2010 (par exemple, site:Redmond). Pour une stratégie créée au niveau de l'étendue Utilisateur, cette valeur sera simplement le nom de la stratégie (par exemple, Reno).

Filter

Facultatif

Chaîne

Chaîne contenant des caractères génériques qui récupérera les stratégies d’emplacement en faisant correspondre la valeur d’identité de la stratégie avec la chaîne de caractères génériques.

LocalStore

Facultatif

Paramètre de commutateur

Récupère les les informations de stratégie d'emplacement à partir du réplica local du magasin central de gestion, plutôt que du magasin central de gestion lui-même.

Types d’entrées

Aucun.

Types de retours

Get-CsLocationPolicy retourne les instances de l'objet Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.

Exemple

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

Get-CsLocationPolicy

L’exemple 1 retourne une collection de toutes les stratégies d’emplacement actuellement utilisées dans votre organisation. Cette opération s'effectue simplement en appelant Get-CsLocationPolicy sans aucun paramètre.

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

Get-CsLocationPolicy -Identity Reno

La commande présentée dans l’exemple 2 retourne uniquement les stratégies d’emplacement dont l’identité est égale à Reno. Parce que les identités doivent être uniques, cette commande retournera au maximum une seule stratégie d’emplacement.

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

Get-CsLocationPolicy -Filter tag:*

La commande précédente utilise le paramètre -Filter pour retourner toutes les stratégies d’emplacement qui ont été configurées au niveau de l’étendue utilisateur. (Les stratégies configurées dans l’étendue utilisateur peuvent être directement affectées aux sites réseau et utilisateurs.) La chaîne de caractères génériques tag:* indique à Get-CsLocationPolicy que les données retournées doivent être limitées aux stratégies d'emplacement dont l'identité commence par la valeur de chaîne tag:. Même s’il n’est pas nécessaire de spécifier le préfixe tag: pour récupérer une stratégie individuelle, vous pouvez utiliser ce préfixe pour effectuer un filtrage de toutes les stratégies utilisateur.

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

Get-CsLocationPolicy | Where-Object {$_.EnhancedEmergencyServicesEnabled -eq $False}

L'exemple 4 retourne une collection de toutes les stratégies d'emplacement, dans lesquelles les services d'urgence sont désactivés. Pour ce faire, la commande utilise d'abord Get-CsLocationPolicy pour retourner une collection de toutes les stratégies d'emplacement actuellement utilisées dans l'organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object ; Where-Object applique ensuite un filtre qui limite les données retournées aux stratégies pour lesquelles la propriété EnhancedEmergencyServicesEnabled est égale à (-eq) False ($False).