TeamsTargetingPolicy

Parameters

Parameter	Attribute	DataType	Description	Allowed Values
IsSingleInstance	Key	String	Only valid value is 'Yes'.	Yes
CustomTagsMode	Write	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.	Disabled, Enabled
Description	Write	String	Pass in a new description if that field needs to be updated.
ManageTagsPermissionMode	Write	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 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.	Disabled, EnabledTeamOwner, EnabledTeamOwnerMember, EnabledTeamOwnerMemberGuest, MicrosoftDefault
ShiftBackedTagsMode	Write	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.	Disabled, Enabled
SuggestedPresetTags	Write	String	TBD
TeamOwnersEditWhoCanManageTagsMode	Write	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 settings.	Disabled, Enabled
Credential	Write	PSCredential	Credentials of the workload's Admin
ApplicationId	Write	String	Id of the Azure Active Directory application to authenticate with.
TenantId	Write	String	Id of the Azure Active Directory tenant used for authentication.
CertificateThumbprint	Write	String	Thumbprint of the Azure Active Directory application's authentication certificate to use for authentication.
CertificatePath	Write	String	Path to certificate used in service principal usually a PFX file.
CertificatePassword	Write	PSCredential	Username can be made up to anything but password will be used for CertificatePassword
ManagedIdentity	Write	Boolean	Managed ID being used for authentication.
AccessTokens	Write	StringArray[]	Access token used for authentication.

Description

This resources configures a Teams Targeting Policy.

Permissions

Examples

Example 1

This example is used to test new resources and showcase the usage of new resources being worked on. It is not meant to use as a production baseline.

Configuration Example
{
    param
    (
        [Parameter()]
        [System.String]
        $ApplicationId,

        [Parameter()]
        [System.String]
        $TenantId,

        [Parameter()]
        [System.String]
        $CertificateThumbprint
    )

    Import-DscResource -ModuleName Microsoft365DSC

    node localhost
    {
        TeamsTargetingPolicy 'Example'
        {
            ApplicationId                      = $ApplicationId;
            CertificateThumbprint              = $CertificateThumbprint;
            CustomTagsMode                     = "Disabled";
            IsSingleInstance                   = "Yes";
            ManageTagsPermissionMode           = "MicrosoftDefault";
            ShiftBackedTagsMode                = "Disabled";
            TeamOwnersEditWhoCanManageTagsMode = "Enabled";
            TenantId                           = $TenantId;
        }
    }
}