Set-CsTeamsChannelsPolicy

Module:: MicrosoftTeams PowerShell module

The CsTeamsChannelsPolicy allows you to manage features related to the Teams and Channels experience within the Teams application.

Syntax

Identity (Default)

Set-CsTeamsChannelsPolicy
    [[-Identity] <XdsIdentity>]
    [-Tenant <Guid>]
    [-AllowOrgWideTeamCreation <Boolean>]
    [-EnablePrivateTeamDiscovery <Boolean>]
    [-AllowPrivateChannelCreation <Boolean>]
    [-AllowUserToParticipateInExternalSharedChannel <Boolean>]
    [-AllowChannelSharingToExternalUser <Boolean>]
    [-AllowSharedChannelCreation <Boolean>]
    [-ThreadedChannelCreation <String>]
    [-AllowCreateChannel <String>]
    [-AllowCreateClassicChannel <String>]
    [-AllowCreatePrivateChannel <String>]
    [-AllowGuestsFromOutsideTeamInPrivateChannel <String>]
    [-AllowSharingPrivateChannelWithTeamInOrg <String>]
    [-AllowSharingWithTeamInOrg <String>]
    [-AllowUsersFromOutsideTeam <String>]
    [-AllowUsersFromOutsideTeamInPrivateChannel <String>]
    [-CreateSharedChannelsByDefault <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Instance

Set-CsTeamsChannelsPolicy
    [[-Identity] <XdsIdentity>]
    [-Tenant <Guid>]
    [-AllowOrgWideTeamCreation <Boolean>]
    [-EnablePrivateTeamDiscovery <Boolean>]
    [-AllowPrivateChannelCreation <Boolean>]
    [-AllowUserToParticipateInExternalSharedChannel <Boolean>]
    [-AllowChannelSharingToExternalUser <Boolean>]
    [-AllowSharedChannelCreation <Boolean>]
    [-ThreadedChannelCreation <String>]
    [-AllowCreateChannel <String>]
    [-AllowCreateClassicChannel <String>]
    [-AllowCreatePrivateChannel <String>]
    [-AllowGuestsFromOutsideTeamInPrivateChannel <String>]
    [-AllowSharingPrivateChannelWithTeamInOrg <String>]
    [-AllowSharingWithTeamInOrg <String>]
    [-AllowUsersFromOutsideTeam <String>]
    [-AllowUsersFromOutsideTeamInPrivateChannel <String>]
    [-CreateSharedChannelsByDefault <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The CsTeamsChannelsPolicy allows you to manage features related to the Teams & Channels experience within the Teams application.

This cmdlet allows you to update existing policies of this type.

Examples

Example 1

PS C:\> Set-CsTeamsChannelsPolicy -Identity StudentPolicy -EnablePrivateTeamDiscovery $true

This example shows updating an existing policy with name "StudentPolicy" and enabling Private Team Discovery.

Parameters

-AllowChannelSharingToExternalUser

Owners of a shared channel can invite external users to join the channel if Microsoft Entra external sharing policies are configured. If the channel has been shared with an external member or team, they will continue to have access to the channel even if this parameter is set to FALSE. For more information, see Manage channel policies in Microsoft Teams.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowCreateChannel

This setting enables/disables Next Generation Channel creation and editing.

Possible values are:

Enabled: Users are allowed.
Disabled: Users are not allowed.

Note

This feature has not been fully released yet, so the setting will have no effect.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowCreateClassicChannel

This setting enables/disables Classic Channel creation and editing.

Possible values are:

Enabled: Users are allowed.
Disabled: Users are not allowed.

Note

This feature has not been fully released yet, so the setting will have no effect.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowCreatePrivateChannel

This setting enables/disables Next Generation Private Channel creation and editing.

Possible values are:

Enabled: Users are allowed.
Disabled: Users are not allowed.

Note

This feature has not been fully released yet, so the setting will have no effect.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowCreateSharedChannel

This setting enables/disables Next Generation Shared Channel creation and editing.

Possible values are:

Enabled: Users are allowed.
Disabled: Users are not allowed.

Note

This feature has not been fully released yet, so the setting will have no effect.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowGuestsFromOutsideTeam

This setting enables/disables whether guests from outside the team are allowed in Next Generation Channels.

Possible values are:

Enabled: Users are allowed.
Disabled: Users are not allowed.

Note

This feature has not been fully released yet, so the setting will have no effect.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowGuestsFromOutsideTeamInPrivateChannel

This setting enables/disables whether guests from outside the team are allowed in Next Generation Private Channels.

Possible values are:

Enabled: Users are allowed.
Disabled: Users are not allowed.

Note

This feature has not been fully released yet, so the setting will have no effect.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowOrgWideTeamCreation

Determines whether a user is allowed to create an org-wide team. Set this to TRUE to allow. Set this FALSE to prohibit.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowPrivateChannelCreation

Determines whether a user is allowed to create a private channel. Set this to TRUE to allow. Set this FALSE to prohibit.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowSharedChannelCreation

Team owners can create shared channels for people within and outside the organization. Only people added to the shared channel can read and write messages.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowSharingPrivateChannelWithTeamInOrg

This setting enables/disables sharing Next Generation Private Channels with Teams in the same organization.

Possible values are:

Enabled: Users are allowed.
Disabled: Users are not allowed.

Note

This feature has not been fully released yet, so the setting will have no effect.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowSharingWithTeamInOrg

This setting enables/disables sharing Next Generation Channels with Teams in the same organization.

Possible values are:

Enabled: Users are allowed.
Disabled: Users are not allowed.

Note

This feature has not been fully released yet, so the setting will have no effect.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowUsersFromOutsideTeam

This setting enables/disables whether users from outside the team are allowed in Next Generation Channels.

Possible values are:

Enabled: Users are allowed.
Disabled: Users are not allowed.

Note

This feature has not been fully released yet, so the setting will have no effect.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowUsersFromOutsideTeamInPrivateChannel

This setting enables/disables whether users from outside the team are allowed in Next Generation Private Channels.

Possible values are:

Enabled: Users are allowed.
Disabled: Users are not allowed.

Note

This feature has not been fully released yet, so the setting will have no effect.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllowUserToParticipateInExternalSharedChannel

Users and teams can be invited to external shared channels if Microsoft Entra external sharing policies are configured. If a team in your organization is part of an external shared channel, new team members will have access to the channel even if this parameter is set to FALSE. For more information, see Manage channel policies in Microsoft Teams.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	cf

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-CreateSharedChannelsByDefault

This setting sets whether users are able to create Next Generation Shared Channels by default.

Possible values are:

Enabled: Users are allowed.
Disabled: Users are not allowed.

Note

This feature has not been fully released yet, so the setting will have no effect.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-EnablePrivateTeamDiscovery

Determines whether a user is allowed to discover private teams in suggestions and search results. Set this to TRUE to allow. Set this FALSE to prohibit.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Force

Bypass all non-fatal errors.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Identity

Use this parameter to specify the name of the policy being updated.

Parameter properties

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

Parameter sets

Identity

Position:	1
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Instance

Use this parameter to pass the policy object output of Get-CsTeamsChannelsPolicy to update that policy.

Parameter properties

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

Parameter sets

Instance

Position:	Named
Mandatory:	False
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Tenant

Internal Microsoft use only.

Parameter properties

Type:	System.Guid
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ThreadedChannelCreation

Note

This parameter is reserved for internal Microsoft use.

This setting enables/disables Threaded Channel creation and editing.

Possible Values:

Enabled: Users are allowed to create and edit Threaded Channels.
Disabled: Users are not allowed to create and edit Threaded Channels.

Parameter properties

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

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	wi

Parameter sets

(All)

Position:	Named
Mandatory:	False
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.