|
| 1 | +--- |
| 2 | +external help file: MicrosoftTeams-help.xml |
| 3 | +Module Name: MicrosoftTeams |
| 4 | +online version: https://learn.microsoft.com/powershell/module/teams/set-csteamsshiftsconnectioninstance |
| 5 | +schema: 2.0.0 |
| 6 | +--- |
| 7 | + |
| 8 | +# Set-CsTeamsTargetingPolicy |
| 9 | + |
| 10 | +## SYNOPSIS |
| 11 | +The CsTeamsTargetingPolicy cmdlets enable administrators to control the type of tags that users can create or the features that they can access in Teams. It also helps determine how tags deal with Teams members or guest users. |
| 12 | + |
| 13 | +## SYNTAX |
| 14 | + |
| 15 | +``` |
| 16 | +Set-CsTeamsTargetingPolicy [-CustomTagsMode <String>] [-Description <String>] [[-Identity] <String>] |
| 17 | + [-ManageTagsPermissionMode <String>] [-ShiftBackedTagsMode <String>] [-SuggestedPresetTags <String>] |
| 18 | + [-TeamOwnersEditWhoCanManageTagsMode <String>] [-MsftInternalProcessingMode <String>] [-WhatIf] [-Confirm] |
| 19 | + [<CommonParameters>] |
| 20 | +``` |
| 21 | + |
| 22 | +## DESCRIPTION |
| 23 | +The CsTeamsTargetingPolicy cmdlets enable administrators to control the type of tags that users can create or the features that they can access in Teams. It also helps determine how tags deal with Teams members or guest users. |
| 24 | + |
| 25 | +The Set-CsTeamsTargetingPolicy cmdlet allows administrators to update existing Tenant tag settings that can be assigned to particular teams to control Team features related to tags. |
| 26 | + |
| 27 | +## EXAMPLES |
| 28 | + |
| 29 | +### Example 1 |
| 30 | +```powershell |
| 31 | +PS C:\> Set-CsTeamsTargetingPolicy -Identity NewTagPolicy -CustomTagsMode Enabled |
| 32 | +``` |
| 33 | + |
| 34 | +The command shown in Example 1 uses the Set-CsTeamsTargetingPolicy cmdlet to update an existing Tenant tag setting with the CustomTagsMode Enabled. This flag will enable Teams users to create tags. |
| 35 | + |
| 36 | +## PARAMETERS |
| 37 | + |
| 38 | +### -Confirm |
| 39 | +Prompts you for confirmation before running the cmdlet. |
| 40 | + |
| 41 | +```yaml |
| 42 | +Type: SwitchParameter |
| 43 | +Parameter Sets: (All) |
| 44 | +Aliases: cf |
| 45 | + |
| 46 | +Required: False |
| 47 | +Position: Named |
| 48 | +Default value: None |
| 49 | +Accept pipeline input: False |
| 50 | +Accept wildcard characters: False |
| 51 | +``` |
| 52 | +
|
| 53 | +### -CustomTagsMode |
| 54 | +Determine whether Teams users can create tags in team. Set this to Enabled to allow users to create new tags. Set this to Disabled to prohibit them from creating new tags. |
| 55 | +
|
| 56 | +```yaml |
| 57 | +Type: String |
| 58 | +Parameter Sets: (All) |
| 59 | +Aliases: |
| 60 | + |
| 61 | +Required: False |
| 62 | +Position: Named |
| 63 | +Default value: None |
| 64 | +Accept pipeline input: False |
| 65 | +Accept wildcard characters: False |
| 66 | +``` |
| 67 | +
|
| 68 | +### -Description |
| 69 | +Pass in a new description if that field needs to be updated. |
| 70 | +
|
| 71 | +```yaml |
| 72 | +Type: String |
| 73 | +Parameter Sets: (All) |
| 74 | +Aliases: |
| 75 | + |
| 76 | +Required: False |
| 77 | +Position: Named |
| 78 | +Default value: None |
| 79 | +Accept pipeline input: False |
| 80 | +Accept wildcard characters: False |
| 81 | +``` |
| 82 | +
|
| 83 | +### -Identity |
| 84 | +Name of the policy instance to be updated. |
| 85 | +
|
| 86 | +```yaml |
| 87 | +Type: String |
| 88 | +Parameter Sets: (All) |
| 89 | +Aliases: |
| 90 | + |
| 91 | +Required: False |
| 92 | +Position: 1 |
| 93 | +Default value: None |
| 94 | +Accept pipeline input: False |
| 95 | +Accept wildcard characters: False |
| 96 | +``` |
| 97 | +
|
| 98 | +### -ManageTagsPermissionMode |
| 99 | +Determine whether team users can manage tag settings in Teams. Set this to EnabledTeamOwner to only allow Teams owners to manage tag settings in current Teams. Set this to EnabledTeamOwnerMember to allow Teams owners and Teams members to manage tag settings in current Teams. Set this to EnabledTeamOwnerMemberGuest to allow Teams owners, Teams members and guest users to manage tag settings in current Teams. Set this to MicrosoftDefault to user default setting in current Teams, which will be the same as EnabledTeamOwner. Set this to Disabled to prohibit all users from managing tag settings in current Teams. |
| 100 | +
|
| 101 | +```yaml |
| 102 | +Type: String |
| 103 | +Parameter Sets: (All) |
| 104 | +Aliases: |
| 105 | + |
| 106 | +Required: False |
| 107 | +Position: Named |
| 108 | +Default value: None |
| 109 | +Accept pipeline input: False |
| 110 | +Accept wildcard characters: False |
| 111 | +``` |
| 112 | +
|
| 113 | +### -MsftInternalProcessingMode |
| 114 | +For Internal use only. |
| 115 | +
|
| 116 | +```yaml |
| 117 | +Type: String |
| 118 | +Parameter Sets: (All) |
| 119 | +Aliases: |
| 120 | + |
| 121 | +Required: False |
| 122 | +Position: Named |
| 123 | +Default value: None |
| 124 | +Accept pipeline input: False |
| 125 | +Accept wildcard characters: False |
| 126 | +``` |
| 127 | +
|
| 128 | +### -ShiftBackedTagsMode |
| 129 | +Determine whether Teams can have tags created by Shift App. Set this to Enabled to allow tags created by Shift App. Set this to Disabled to prohibit tags from Shift App. |
| 130 | +
|
| 131 | +```yaml |
| 132 | +Type: String |
| 133 | +Parameter Sets: (All) |
| 134 | +Aliases: |
| 135 | + |
| 136 | +Required: False |
| 137 | +Position: Named |
| 138 | +Default value: None |
| 139 | +Accept pipeline input: False |
| 140 | +Accept wildcard characters: False |
| 141 | +``` |
| 142 | +
|
| 143 | +### -TeamOwnersEditWhoCanManageTagsMode |
| 144 | +Determine whether Teams owners can change Tenant tag settings. Set this to Enabled to allow Teams owners to change Tenant tag settings for current Teams. Set this to Disabled to prohibit them from changing Tenant tag settings. |
| 145 | +
|
| 146 | +```yaml |
| 147 | +Type: String |
| 148 | +Parameter Sets: (All) |
| 149 | +Aliases: |
| 150 | + |
| 151 | +Required: False |
| 152 | +Position: Named |
| 153 | +Default value: None |
| 154 | +Accept pipeline input: False |
| 155 | +Accept wildcard characters: False |
| 156 | +``` |
| 157 | +
|
| 158 | +### -WhatIf |
| 159 | +Shows what would happen if the cmdlet runs. |
| 160 | +The cmdlet is not run. |
| 161 | +
|
| 162 | +```yaml |
| 163 | +Type: SwitchParameter |
| 164 | +Parameter Sets: (All) |
| 165 | +Aliases: wi |
| 166 | + |
| 167 | +Required: False |
| 168 | +Position: Named |
| 169 | +Default value: None |
| 170 | +Accept pipeline input: False |
| 171 | +Accept wildcard characters: False |
| 172 | +``` |
| 173 | +
|
| 174 | +### CommonParameters |
| 175 | +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). |
| 176 | +
|
| 177 | +## INPUTS |
| 178 | +
|
| 179 | +### None |
| 180 | +
|
| 181 | +## OUTPUTS |
| 182 | +
|
| 183 | +### System.Object |
| 184 | +## NOTES |
| 185 | +
|
| 186 | +## RELATED LINKS |
0 commit comments