Set-CsTeamsChannelsPolicy

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

Syntax

Set-CsTeamsChannelsPolicy
   [-Tenant <Guid>]
   [-AllowOrgWideTeamCreation <Boolean>]
   [-EnablePrivateTeamDiscovery <Boolean>]
   [-AllowPrivateChannelCreation <Boolean>]
    [-AllowUserToParticipateInExternalSharedChannel <Boolean>]
   [-AllowChannelSharingToExternalUser <Boolean>]
   [-AllowSharedChannelCreation <Boolean>]
   [[-Identity] <XdsIdentity>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CsTeamsChannelsPolicy
   [-Tenant <Guid>]
   [-AllowOrgWideTeamCreation <Boolean>]
   [-EnablePrivateTeamDiscovery <Boolean>]
   [-AllowPrivateChannelCreation <Boolean>]
   [-AllowUserToParticipateInExternalSharedChannel <Boolean>]
   [-AllowChannelSharingToExternalUser <Boolean>]
   [-AllowSharedChannelCreation <Boolean>]
   [-Instance <PSObject>]
   [-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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowPrivateChannelCreation

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Bypass all non-fatal errors.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Identity

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

Type:XdsIdentity
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Instance

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

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tenant

Internal Microsoft use only.

Type:System.Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

System.Management.Automation.PSObject

Outputs

System.Object