Parameters

The location policy is used to apply settings that relate to E9-1-1 functionality. The location policy determines whether a user is enabled for E9-1-1, and if so what the behavior is of an emergency call. For example, you can use the location policy to define what number constitutes an emergency call (911 in the United States), whether corporate security should be automatically notified, how the call should be routed, and so on. This cmdlet retrieves one or more location policies.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsLocationPolicy cmdlet locally: RTCUniversalUserAdmins, RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsLocationPolicy"}

None.

Get-CsLocationPolicy returns instances of the Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy object.

-------------------------- Example 1 --------------------------

	Copy Code
Get-CsLocationPolicy

Example 1 returns a collection of all the location policies currently in use in your organization. This is done simply by calling Get-CsLocationPolicy without any parameters.

-------------------------- Example 2 --------------------------

	Copy Code
Get-CsLocationPolicy -Identity Reno

The command shown in Example 2 returns only those location policies that have an Identity equal to Reno. Because identities must be unique, this command will only return, at most, one location policy.

-------------------------- Example 3 --------------------------

	Copy Code
Get-CsLocationPolicy -Filter tag:*

The preceding command uses the Filter parameter to return all the location policies that have been configured at the per-use scope. (Policies configured at the per-user scope can be directly assigned to users and network sites.) The wildcard string tag:* tells Get-CsLocationPolicy that the returned data should be limited to those location policies that have an Identity that begins with the string value tag:. Even though you don’t need to specify the tag: prefix when retrieving an individual policy, you can use that prefix to filter on all per-user policies.

-------------------------- Example 4 --------------------------

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

Example 4 returns a collection of all the location policies where enhanced emergency services are disabled. To do this, the command first uses Get-CsLocationPolicy to return a collection of all the location policies currently in use in the organization. That collection is then piped to the Where-Object cmdlet; in turn, Where-Object applies a filter that limits the returned data to those policies where the EnhancedEmergencyServicesEnabled property is equal to (-eq) False ($False).

Other Resources