Set-CsMobilityPolicy

 

Topic Last Modified: 2017-05-17

ImportantImportant:
This only applies to Skype for Business Online and not to Skype for Business Server or Lync on-premises deployments.
ImportantImportant:
Please note that if your organization utilizes custom policies, then the UI will no longer correctly reflect the policy values. Once they are implemented they must continue to be managed via PowerShell.

Modifies an existing mobility policy. Mobility policies determine whether or not a user can use the Skype for Business app. These policies also manage a user's ability to employ Call via Work, a feature that enables users to make and receive phone calls on their mobile phone by using their work phone number instead of their mobile phone number. Mobility policies can also be used to require Wi-Fi connections when making or receiving calls.

Set-CsMobilityPolicy [-Identity <XdsIdentity>] <COMMON PARAMETERS>

Set-CsMobilityPolicy [-Instance <PSObject>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-AllowDeviceContactsSync <$true | $false>]  [-AllowSaveCredentials <$true | $false>] [-AllowSaveIMHistory <$true | $false>]  [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableIPAudioVideo <$true | $false>] [-EnableMobility <$true | $false>] [-EnableOutsideVoice <$true | $false>] [-EnablePushNotifications <$true | $false>] [-Force <SwitchParameter>] [-RequireWIFIForIPVideo <$true | $false>] [-RequireWiFiForSharing <$true | $false>] [-WhatIf [<SwitchParameter>]

In Example 1, Call via Work is disabled in the mobility policy assigned to a user Amos Marble. This is done by setting the EnableOutsideVoice property to False.

Set-CsMobilityPolicy -Identity "amos.marble@contoso.com" -EnableOutsideVoice $False

The command shown in Example 2 disables Call via Work for all the mobility policies configured at the per-user scope. To carry out this task, the command first calls the Get-CsMobilityPolicy cmdlet along with the Filter parameter; the filter value "tag:*" limits the returned data to policies that have an Identity that begins with the string value "tag:". That filtered collection of policies is then piped to the Set-CsMobilityPolicy cmdlet, which takes each policy in the collection and sets the EnableOutsideVoice property to False.

Get-CsMobilityPolicy -Filter "tag:*" | Set-CsMobilityPolicy -EnableOutsideVoice $False

In Example 3, a new description is added to any mobility policy property that does not currently have a description. To do this, the first uses the Get-CsMobilityPolicy cmdlet to return a collection of all the mobility policies currently in use in the organization. This collection is then piped to the Where-Object cmdlet, which selects only those policies where the Description property is equal to (-eq) a null value. That filtered collection is then piped to the Set-CsMobilityPolicy cmdlet, which sets the Description property for each policy to the string value "Policy owner: kenmyer@litwareinc.com".

Get-CsMobilityPolicy | Where-Object {$_.Description -eq $Null} | Set-CsMobilityPolicy -Description "Policy owner: kenmyer@litwareinc.com"

Skype for Business app is an application that enables users to run Skype for Business on their mobile phones. Call via Work provides a way for users to make calls on their mobile phone and yet have it appear as though the call originated from their work phone number instead of their mobile phone number. Users who have been enabled for Call via Work can achieve this either by dialing directly from their mobile phone or by using the dial-out conferencing option. With dial-out conferencing, a user effectively asks the to make a call for them. Skype for Business Online will set up the call, and then call the user back on their mobile phone. After the user has answered, Skype for Business Online will then dial the party being called. Both of these capabilities can be managed by using mobility policies.

WithSkype for Business Online, mobile devices can make or receive phone calls by using either the standard cellular phone network. or by using Wi-Fi connections. Mobility policies can be used to require Wi-Fi connections and to prevent calls over the cellular network.

These policies can be modified at any time by using the Set-CsMobilityPolicy cmdlet.

Note that two different properties must be configured in order to enable Call via Work. The first property, EnableOutsideVoice, determines whether or not Call via Work is enabled; the second, EnableMobility, determines whether or not users are allowed to use Skype for Business on a mobile device. Both of these properties must be set to true before a user can take advantage of Call via Work. If EnableMobility is set to True and EnableOutsideVoice is set to False, the user can run Skype for Business on a mobile device but won't be able to use Call via Work. If EnableMobility is set to False and EnableOutsideVoice is set to True the user will not be able to run Skype for Business on a mobile device. In turn, that means that the user will not be able to use Call via Work, regardless of the value of the EnableOutsideVoice property.

To use Call via Work, users must be managed by a voice policy that allows simultaneous ringing.

 

Parameter Required Type Description

Identity

Required

Microsoft.Rtc.Management.Xds.XdsIdentity

Unique Identity to be assigned to the policy. New mobility policies can be created at the per-user scope.

To create a new per-user policy, use an Identity similar to this:

-Identity SalesDepartmentPolicy

Note that you cannot create a new global policy; if you want to make changes to the global policy, use the Set-CsMobilityPolicy cmdlet instead. Likewise, you cannot create a new per-user policy if a policy with that Identity already exists. If you need to make changes to an existing policy, use the Set-CsMobilityPolicy cmdlet.

AllowDeviceContactsSync

Optional

System.Boolean

When set to True, contacts from a mobile device are synchronized with the Skype for Business client. When set to False, contacts on the mobile device won't be synchronized.

AllowSaveCredentials

Optional

System.Boolean

When set to True (the default value) users will be allowed to save credentials information (such as passwords) on their mobile device. This information can then be applied to auto-logon scenarios.

AllowSaveIMHistory

Optional

System.Boolean

When set to True (the default value) users will be allowed to save transcripts of IM and conferencing sessions on their mobile devices.

Confirm

Optional

System.Management.Automation.SwitchParameter

Prompts you for confirmation before executing the command.

EnableIPAudioVideo

Optional

System.Boolean

When set to False, prohibits the user from making voice over IP (VoIP) calls using the mobile device. The default value is True, meaning that VoIP calls are allowed.

EnableMobility

Optional

System.Boolean

When set to True, users are allowed to use Skype for Business app.

EnableOutsideVoice

Optional

System.Boolean

When set to True, enables users to take advantage of Call via Work. When set to False, users cannot use Call via Work.

The default value is True.

EnablePushNotifications

Optional

System.Boolean

When set to True, the mobile device that is used by a user will receive notifications on that mobile device. Set to False no notifications will be sent to the mobile device.

Force

Optional

System.Management.Automation.SwitchParameter

Suppresses the display of any non-fatal error message that might occur when running the command.

RequireWIFIForIPVideo

Optional

System.Boolean

When set to True, the user can use IP video only in calls made when mobile device is connected to a Wi-Fi network. If mobile device goes outside of Wi-Fi range, then video calls will be received as audio calls only. If this property is set to False (the default value) then the user can make or receive IP video calls in using either a Wi-Fi or a cellular data connection.

RequireWiFiForSharing

Optional

System.Boolean

When set to True, mobile users must use a WiFi connection in order to participate in an application sharing session. When set to False (the default value) mobile users can participate in application sharing by using either a WiFi connection or a cellular (3G/4G) connection.

If this value is set to True, then users then users will not be able to change their sharing configuration settings. If this value is set to False users can use the Options page to modify their sharing configuration settings.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Describes what would happen if you executed the command without actually executing the command.

Microsoft.Rtc.Management.WriteableConfig.Policy.Mobility.Mobility. The Set-CsMobilityPolicy cmdlet accepts pipelined instances of the Mobility object.

None. Instead, the Set-CsMobilityPolicy cmdlet modifies existing instances of the Microsoft.Rtc.Management.WriteableConfig.Policy.Mobility.Mobility object.

 
Show: