Commands › Microsoft Teams

Set-CsTeamsTargetingPolicy

Microsoft Teams MicrosoftTeams Set-*

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.

Quick start script

# Set-CsTeamsTargetingPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsTeamsTargetingPolicy
$before | Format-List

# 3. Make the change (dry run first)
Set-CsTeamsTargetingPolicy  -WhatIf
Set-CsTeamsTargetingPolicy

# 4. Verify and diff
$after = Get-CsTeamsTargetingPolicy
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

Set-CsTeamsTargetingPolicy [-CustomTagsMode <String>] [-Description <String>] [[-Identity] <String>]
 [-ManageTagsPermissionMode <String>] [-ShiftBackedTagsMode <String>] [-SuggestedPresetTags <String>]
 [-TeamOwnersEditWhoCanManageTagsMode <String>] [-MsftInternalProcessingMode <String>] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Parameters (9)

Parameter	Type	What it controls
-Confirm	SwitchParameter	Prompts you for confirmation before running the cmdlet.
-CustomTagsMode	String	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.
-Description	String	Pass in a new description if that field needs to be updated.
-Identity	String	Name of the policy instance to be updated.
-ManageTagsPermissionMode	String	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...
-MsftInternalProcessingMode	String	For Internal use only.
-ShiftBackedTagsMode	String	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.
-TeamOwnersEditWhoCanManageTagsMode	String	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...
-WhatIf	SwitchParameter	Shows what would happen if the cmdlet runs. The cmdlet is not run.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.