Create Location Policies

[This is pre-release documentation and subject to change in future releases. This topic's current status is: Ready for Copy Edit]

Topic Last Modified: 2010-07-16

Communications Server uses a Location Policy to enable Communications Server clients for E9-1-1 during client registration. A Location Policy contains the settings that define how E9-1-1 will be implemented.

You can edit the global Location policy and create new tagged Location policies. A client obtains a global policy when not located within a subnet with an associated location policy, or when the client has not been directly assigned a location policy. Tagged policies are assigned to subnets or users.

For a complete description of Location policies, see Client Enablement. Cmdlets in this procedure use a location policy defined using the following values:

Element	Value
EnhancedEmergencyServicesEnabled	True
LocationRequired	Yes
UseLocationForE911Only	False
PstnUsage	EmergencyUsage
EmergencyDialString	911
EmergencyDialMask	112
NotificationUri	sip:security@litware.com
ConferenceUri	sip:+14255550123@litware.com
ConferenceMode	twoway

For more information about working with location policies, see the Communications Server Management Shell documentation for the following cmdlets:

New-CsLocationPolicy
Get-CsLocationPolicy
Set-CsLocationPolicy
Remove-CsLocationPolicy
Grant-CsLocationPolicy

To create location policies

Open Communications Server Management Shell.

Note:

CsLocationPolicy will fail if the setting for PstnUsage is not already in the Global list of PstnUsages.

Note:
CsLocationPolicy will fail if the setting for PstnUsage is not already in the Global list of PstnUsages.

Optionally, run the following cmdlet to edit the global Location Policy:

	Copy Code
Set-CsLocationPolicy –Identity Global –EnhancedEmergencyServicesEnabled $true –LocationRequired “yes” –PstnUsage “emergencyUsage” –EmergencyDialString “911” –ConferenceMode “twoway” –ConferenceUri "sip:+14255550123@litware.com" –EmergencyDialMask “112” NotificationUri "sip:security@litware.com" -UseLocationForE911Only $true

Copy Code

Set-CsLocationPolicy –Identity Global –EnhancedEmergencyServicesEnabled $true –LocationRequired “yes” –PstnUsage “emergencyUsage” –EmergencyDialString “911” –ConferenceMode “twoway” –ConferenceUri "sip:+14255550123@litware.com" –EmergencyDialMask “112” NotificationUri "sip:security@litware.com" -UseLocationForE911Only $true

Run the following to create a tagged Location Policy.

	Copy Code
New-CsLocationPolicy -Identity Tag:Redmond – EnhancedEmergencyServicesEnabled $true -LocationRequired "yes" -UseLocationForE911Only $false -PstnUsage "EmergencyUsage" -EmergencyDialString "911" -EmergencyDialMask "112" -NotificationUri "sip:security@litware.com" -ConferenceUri "sip:+14255550123@litware.com" -ConferenceMode "twoway"

Copy Code

New-CsLocationPolicy -Identity Tag:Redmond – EnhancedEmergencyServicesEnabled $true -LocationRequired "yes" -UseLocationForE911Only $false -PstnUsage "EmergencyUsage" -EmergencyDialString "911" -EmergencyDialMask "112" -NotificationUri "sip:security@litware.com" -ConferenceUri "sip:+14255550123@litware.com" -ConferenceMode "twoway"

Run the following cmdlet to apply the tagged Location Policy created in step 3 to a user policy.
Copy Code
(Get-csUser | where { $_.Name -match “UserName” }) | Grant-csLocationPolicy -PolicyName Redmond