Edit

Share via


Update-CsCustomPolicyPackage

Note: This cmdlet is currently in private preview.

This cmdlet updates a custom policy package.

Syntax

Default (Default)

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

Applicable: Microsoft Teams

The description of the custom package.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identity

Applicable: Microsoft Teams

The name of the custom package.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PolicyList

Applicable: Microsoft Teams

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.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

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.