New-CsTeamsChannelsPolicy
The CsTeamsChannelsPolicy allows you to manage features related to the Teams & Channels experience within the Teams application.
Syntax
Default (Default)
New-CsTeamsChannelsPolicy
[-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>]
[[-Identity] <XdsIdentity>]
[-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 create new policies of this type, which can later be assigned to specific users.
Examples
Example 1
PS C:\> New-CsTeamsChannelsPolicy -Identity StudentPolicy -EnablePrivateTeamDiscovery $false
This example shows creating a new policy with name "StudentPolicy" where Private Team Discovery is disabled.
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 |
-Description
Specifies the description of the policy.
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
Bypasses 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
Specify the name of the policy that you are creating.
Parameter properties
| Type: | String |
| 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 |
-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.