|
| 1 | +--- |
| 2 | +external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml |
| 3 | +Module Name: Skype for Business Online |
| 4 | +online version: https://docs.microsoft.com/powershell/module/skype/grant-csteamsipphonepolicy |
| 5 | +applicable: Skype for Business Online |
| 6 | +title: Grant-CSTeamsIPPhonePolicy |
| 7 | +author: tonywoodruff |
| 8 | +ms.author: anwoodru |
| 9 | +ms.reviewer: kponnus |
| 10 | +manager: sandrao |
| 11 | +schema: 2.0.0 |
| 12 | +--- |
| 13 | + |
| 14 | +# Grant-CsTeamsIPPhonePolicy |
| 15 | + |
| 16 | +## SYNOPSIS |
| 17 | + |
| 18 | +Use the Grant-CSTeamsIPPhonePolicy cmdlet to assign a set of Teams phone policies to a user account or group of user accounts. Teams phone policies determine the features that are available to users of Teams phones. For example, you might enable the hot desking feature for some users while disabling it for others. |
| 19 | + |
| 20 | + |
| 21 | +## SYNTAX |
| 22 | + |
| 23 | +``` |
| 24 | +Grant-CsTeamsIPPhonePolicy [-PassThru] [-Confirm] [[-PolicyName] <XdsIdentity>] [[-Identity] <Object>] [-Global] |
| 25 | + [-Tenant <Guid>] [-DomainController <Object>] [-WhatIf] [-AsJob] |
| 26 | +``` |
| 27 | + |
| 28 | +## DESCRIPTION |
| 29 | +Use the Grant-CSTeamsIPPhonePolicy cmdlet to assign a set of Teams phone policies to a phone signed in with an account that may be used by end users, common area phones, or meeting room accounts. |
| 30 | + |
| 31 | +Note: Assigning a per user policy will override any global policy taking effect against the respective user account. |
| 32 | + |
| 33 | +## EXAMPLES |
| 34 | + |
| 35 | +### Example 1 |
| 36 | +```powershell |
| 37 | +PS C:\> Grant-CsTeamsIPPhonePolicy -Identity [email protected] -PolicyName CommonAreaPhone |
| 38 | +``` |
| 39 | + |
| 40 | +This example shows assignment of the CommonAreaPhone policy to user account [email protected]. |
| 41 | + |
| 42 | + |
| 43 | +## PARAMETERS |
| 44 | + |
| 45 | +### -Confirm |
| 46 | +Prompts you for confirmation before running the cmdlet. |
| 47 | + |
| 48 | +```yaml |
| 49 | +Type: SwitchParameter |
| 50 | +Parameter Sets: (All) |
| 51 | +Aliases: cf |
| 52 | + |
| 53 | +Required: False |
| 54 | +Position: Named |
| 55 | +Default value: None |
| 56 | +Accept pipeline input: False |
| 57 | +Accept wildcard characters: False |
| 58 | +``` |
| 59 | +
|
| 60 | +### -DomainController |
| 61 | +Microsoft Internal Use Only. |
| 62 | +
|
| 63 | +```yaml |
| 64 | +Type: Object |
| 65 | +Parameter Sets: (All) |
| 66 | +Aliases: |
| 67 | + |
| 68 | +Required: False |
| 69 | +Position: Named |
| 70 | +Default value: None |
| 71 | +Accept pipeline input: False |
| 72 | +Accept wildcard characters: False |
| 73 | +``` |
| 74 | +
|
| 75 | +### -Global |
| 76 | +Use this parameter to make the specified policy in -PolicyName the new effective global policy. |
| 77 | +
|
| 78 | +```yaml |
| 79 | +Type: SwitchParameter |
| 80 | +Parameter Sets: (All) |
| 81 | +Aliases: |
| 82 | + |
| 83 | +Required: False |
| 84 | +Position: Named |
| 85 | +Default value: None |
| 86 | +Accept pipeline input: False |
| 87 | +Accept wildcard characters: False |
| 88 | +``` |
| 89 | +
|
| 90 | +### -Identity |
| 91 | +Indicates the identity of the user account the policy should be assigned to. |
| 92 | +
|
| 93 | +```yaml |
| 94 | +Type: Object |
| 95 | +Parameter Sets: (All) |
| 96 | +Aliases: |
| 97 | + |
| 98 | +Required: False |
| 99 | +Position: 0 |
| 100 | +Default value: None |
| 101 | +Accept pipeline input: False |
| 102 | +Accept wildcard characters: False |
| 103 | +``` |
| 104 | +
|
| 105 | +### -PassThru |
| 106 | +Including this parameter (which does not take a value) displays the user information when the cmdlet completes. Normally there is no output when this cmdlet is run. |
| 107 | +
|
| 108 | +```yaml |
| 109 | +Type: SwitchParameter |
| 110 | +Parameter Sets: (All) |
| 111 | +Aliases: |
| 112 | + |
| 113 | +Required: False |
| 114 | +Position: Named |
| 115 | +Default value: None |
| 116 | +Accept pipeline input: False |
| 117 | +Accept wildcard characters: False |
| 118 | +``` |
| 119 | +
|
| 120 | +### -PolicyName |
| 121 | +The Identity of the Teams phone policy to apply to the user. |
| 122 | +
|
| 123 | +```yaml |
| 124 | +Type: XdsIdentity |
| 125 | +Parameter Sets: (All) |
| 126 | +Aliases: |
| 127 | + |
| 128 | +Required: False |
| 129 | +Position: 1 |
| 130 | +Default value: None |
| 131 | +Accept pipeline input: False |
| 132 | +Accept wildcard characters: False |
| 133 | +``` |
| 134 | +
|
| 135 | +### -Tenant |
| 136 | +Microsoft internal usage only. |
| 137 | +
|
| 138 | +```yaml |
| 139 | +Type: Guid |
| 140 | +Parameter Sets: (All) |
| 141 | +Aliases: |
| 142 | + |
| 143 | +Required: False |
| 144 | +Position: Named |
| 145 | +Default value: None |
| 146 | +Accept pipeline input: False |
| 147 | +Accept wildcard characters: False |
| 148 | +``` |
| 149 | +
|
| 150 | +### -WhatIf |
| 151 | +Shows what would happen if the cmdlet runs. |
| 152 | +The cmdlet is not run. |
| 153 | +
|
| 154 | +```yaml |
| 155 | +Type: SwitchParameter |
| 156 | +Parameter Sets: (All) |
| 157 | +Aliases: wi |
| 158 | + |
| 159 | +Required: False |
| 160 | +Position: Named |
| 161 | +Default value: None |
| 162 | +Accept pipeline input: False |
| 163 | +Accept wildcard characters: False |
| 164 | +``` |
| 165 | +
|
| 166 | +### -AsJob |
| 167 | +Indicates that this cmdlet runs as a background job. |
| 168 | +
|
| 169 | +When you specify the AsJob parameter, the command immediately returns an object that represents the background job. You can continue to work in the session while the job finishes. The job is created on the local computer and the results from the Skype for Business Online session are automatically returned to the local computer. To get the job results, use the Receive-Job cmdlet. |
| 170 | +
|
| 171 | +```yaml |
| 172 | +Type: SwitchParameter |
| 173 | +Parameter Sets: (All) |
| 174 | +Aliases: |
| 175 | + |
| 176 | +Required: False |
| 177 | +Position: Named |
| 178 | +Default value: None |
| 179 | +Accept pipeline input: False |
| 180 | +Accept wildcard characters: False |
| 181 | +``` |
| 182 | +
|
| 183 | +## INPUTS |
| 184 | +
|
| 185 | +### Microsoft.Rtc.Management.AD.UserIdParameter |
| 186 | +
|
| 187 | +## OUTPUTS |
| 188 | +
|
| 189 | +### System.Object |
| 190 | +
|
| 191 | +## NOTES |
| 192 | +
|
| 193 | +## RELATED LINKS |
0 commit comments