Partager via

  • Article

Grant-CsLocationPolicy

 

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

Attribue une stratégie d’emplacement Enhanced 9-1-1 (E9-1-1) à des utilisateurs individuels ou des groupes. Le système E9-1-1 permet à des personnes répondant à des appels d’urgence de déterminer la position géographique de l’appelant.

Syntaxe

Grant-CsLocationPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La stratégie d’emplacement permet d’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), de déterminer si le service de sécurité de l’entreprise doit être automatiquement averti et comment l’appel doit être acheminé. Cette cmdlet attribue une stratégie d’emplacement à un utilisateur ou un groupe spécifique.

IMPORTANT : la stratégie d’emplacement a un comportement différent des autres stratégies dans Microsoft Lync Server 2010 en termes d’ordre d’application d’étendue. Pour toutes les autres stratégies, si une stratégie est définie au niveau de l’étendue Utilisateur, la stratégie est appliquée à tous les utilisateurs à qui elle a été octroyée. Si aucune stratégie au niveau de l’étendue Utilisateur n’a été accordée aux utilisateurs, la stratégie de site est appliquée. S’il n’existe aucune stratégie de site, la stratégie globale est appliquée. Les stratégies d’emplacement sont appliquées de la même manière, avec une exception : une stratégie d’emplacement utilisateur peut également être affectée à un site réseau. (Un site réseau est composé d’un groupe de sous-réseaux.) Si l’utilisateur effectue l’appel d’urgence depuis un emplacement mappé sur un site réseau dans l’organisation, la stratégie au niveau de l’utilisateur affectée à ce réseau est utilisée. Cette fonctionnalité remplacera une stratégie utilisateur qui a été octroyée à cet utilisateur. Si l’utilisateur appelle d’un emplacement inconnu ou non mappé dans l’organisation, l’étendue de stratégie standard sera appliquée.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Grant-CsLocationPolicy : RTCUniversalUserAdmins. 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 "Grant-CsLocationPolicy"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Paramètre ID utilisateur

Indique l’identité du compte d’utilisateur auquel la stratégie doit être affectée. Les identités utilisateur peuvent être spécifiées dans l’un des quatre formats suivants : 1) L’adresse SIP de l’utilisateur ; 2) Le nom d’utilisateur principal de l’utilisateur ; 3) Le nom de domaine et le nom d’ouverture de session de l’utilisateur, sous la forme domaine\ouverture de session (par exemple, litwareinc\kenmyer) ; et 4) Le nom complet Active Directory de l’utilisateur (par exemple, Ken Myer). Notez que le nom SAMAccountName ne peut pas être utilisé en guise d’identité.

En outre, vous pouvez recourir à l’astérisque (caractère générique *) si vous utilisez le nom complet comme identité utilisateur. Par exemple, l’identité « * Smith » octroie la stratégie à tous les utilisateurs dont le nom de famille est Smith.

DomainController

Facultatif

FQDN

Permet de spécifier un contrôleur de domaine. Si aucun contrôleur de domaine n’est spécifié, c’est le premier contrôleur disponible qui sera utilisé.

PassThru

Facultatif

Paramètre de commutateur

Lorsque ce paramètre (qui ne prend aucune valeur) est inclus, les informations relatives à l’utilisateur apparaissent lorsque la cmdlet a fini de s’exécuter. Aucun résultat n’est normalement fourni lorsque vous exécutez cette cmdlet.

PolicyName

Facultatif

Chaîne

Identité de la stratégie d’emplacement à appliquer à l’utilisateur.

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

Chaîne. Accepte une valeur de chaîne transmise via le pipeline représentant l’identité d’un compte d’utilisateur auquel la stratégie d’emplacement est accordée.

Types de retours

Utilisée avec le paramètre PassThru, retourne un objet de type Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact.

Exemple

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

Grant-CsLocationPolicy -Identity "Ken Myer" -PolicyName Reno

Dans l’exemple 1, la cmdlet Grant-CsLocationPolicy est utilisée pour attribuer la stratégie d’emplacement Reno à l’utilisateur Ken Myer.

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

Get-CsUser -LDAPFilter "Department=Accounting" | Grant-CsLocationPolicy -PolicyName AccountingArea

Dans l’exemple 2, la stratégie AccountingArea est attribuée à tous les utilisateurs qui sont dans le service Accounting (comptabilité). Pour retourner une collection de tous les utilisateurs dans le service Accounting, la cmdlet Get-CsUser est utilisée avec le paramètre LDAPFilter. La valeur de la requête transmise à LDAPFilter--"Department=Accounting" retourne tous les utilisateurs dont le paramètre Active Directory Department indique Accounting. Cette collection est ensuite transmise à la cmdlet Grant-CsLocationPolicy qui attribue la stratégie AccountingArea à chacun des utilisateurs figurant dans la collection.

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

Grant-CsLocationPolicy -Identity "Ken Myer" -PolicyName Reno -PassThru | Select-Object DisplayName, LocationPolicy

Cet exemple octroie la stratégie d’emplacement Reno à l’utilisateur avec l’identité (dans ce cas, le nom complet) Ken Myer. En outre, l’exemple inclut le paramètre PassThru qui affiche les informations relatives à l’utilisateur Ken Myer une fois que la stratégie d’emplacement a été octroyée à ce dernier. Cependant, au lieu d’afficher immédiatement les informations relatives à l’utilisateur dans la console, ces informations sont redirigées vers la cmdlet Select-Object qui affiche uniquement les propriétés DisplayName et LocationPolicy de l’utilisateur.

Dans cet exemple, vous pouvez constater que la nouvelle stratégie d’emplacement octroyée apparaît dans la sortie sous LocationPolicy mais qu’elle apparaît en tant que valeur Anchor et non en tant que nom de stratégie. (Une valeur Anchor est une valeur numérique attribuée automatiquement à une stratégie au moment de sa création.) Pour voir si le nom de la stratégie a été appliqué, exécutez la commande Get-CsUser –Identity "Ken Myer" | Select-Object DisplayName, LocationPolicy.