Grant-CsCallViaWorkPolicy
Use the Grant-CsCallViaWorkPolicy cmdlet to assign call via work policies to a user or group of users. Call via work policies enable and manage the characteristics of outbound calls placed through the Skype for Business client.
Grant-CsCallViaWorkPolicy
[-Identity] <UserIdParameter>
[-PolicyName] <String>
[-Confirm]
[-DomainController <Fqdn>]
[-PassThru]
[-WhatIf]
[<CommonParameters>]
This cmdlet assigns an existing per-user call via work policy to a user. Call via work policies are used to control access to the feature and manage the characteristics of outbound calls placed through the Skype for Business client.
Grant-CsCallViaWorkPolicy -Identity "Ken Myer" -PolicyName StandardUserCvW
This example assigns the policy named "StandardUserCvW" to "Ken Myer".
Prompts you for confirmation before executing the command.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
Enables you to specify the fully qualified domain name (FQDN) of a domain controller to be contacted when assigning the new policy. If this parameter is not specified, then the Grant-CsCallViaWorkPolicy cmdlet will contact the first available domain controller.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
Specifies a unique identifier of the user account the policy should be assigned to. User identities can be specified by using one of four formats.
SIP address
User Principal Name (UPN)
Domain name and logon name, in the form domain\logon
Active Directory display name (Ken Myer), or distinguished name
In addition, you can use the asterisk (*) wildcard character when using the display name as the user Identity. For example, the Identity "* Smith" grants the policy all users who have a display name that ends in the string value " Smith".
Type: | UserIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
Enables you to pass a user object through the pipeline that represents the user being assigned the policy. By default, the Grant-CsCallViaWorkPolicy cmdlet does not pass objects through the pipeline.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
Specifies the name of the policy to be assigned.
The PolicyName is the policy identity minus the policy scope ("tag:").
A policy that has an identity of "Tag:Redmond" has a PolicyName of "Redmond".
A policy with the identity "Tag:RedmondCalloutPolicy" has a PolicyName of "RedmondCalloutPolicy".
If you set PolicyName to a null value, then the command will unassign any individual policy assigned to the user.
For example: Grant-CsCallViaWorkPolicy -Identity "Ken Myer" -PolicyName $Null
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
The WhatIf switch causes the command to simulate its results. By using this switch, you can view what changes would occur without having to commit those changes.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
None.
None.