Edit

Share via

Update-CsCustomPolicyPackage

  • Reference
Module:
MicrosoftTeamsPowerShell

Note: This cmdlet is currently in private preview.

This cmdlet updates a custom policy package.

Syntax

Update-CsCustomPolicyPackage
      -Identity <String>
      -PolicyList <String[]>
      [-Description <String>]
      [<CommonParameters>]

Description

This cmdlet updates a custom policy package with new package settings. For more information on policy packages and the policy types available, please review https://learn.microsoft.com/MicrosoftTeams/manage-policy-packages.

Examples

Example 1

PS C:\> Update-CsCustomPolicyPackage -Identity "MyPackage" -PolicyList "TeamsMessagingPolicy, MyMessagingPolicy"

Updates the custom package named "MyPackage" to have one policy in the package: a messaging policy of name "MyMessagingPolicy".

Example 2

PS C:\> Update-CsCustomPolicyPackage -Identity "MyPackage" -PolicyList "TeamsMessagingPolicy, MyMessagingPolicy", "TeamsMeetingPolicy, MyMeetingPolicy" -Description "My package"

Updates the custom package named "MyPackage" to have a description of "My package" and two policies in the package: a messaging policy of name "MyMessagingPolicy" and a meeting policy of name "MyMeetingPolicy".

Parameters

-Description

The description of the custom package.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-Identity

The name of the custom package.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-PolicyList

A list of one or more policies to be included in the updated package. To specify the policy list, follow this format: "<PolicyType>, <PolicyName>". Delimiters of ' ', '.', ':', '\t' are also acceptable. Supported policy types are listed here. To get the list of available policy names on your tenant, use the skypeforbusiness module and refer to cmdlets such as Get-CsTeamsMeetingPolicy and Get-CsTeamsMessagingPolicy.

Type:String[]
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

Notes

The resulting custom package's contents will be replaced by the new one instead of a union. Default packages created by Microsoft cannot be updated.