Update-MgTeam

Reference

Module:: Microsoft.Graph.Teams

Update the properties of the specified team.

Note

To view the beta release of this cmdlet, view Update-MgBetaTeam

Syntax

Update-MgTeam
      -TeamId <String>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-AllChannels <IMicrosoftGraphChannel[]>]
      [-Channels <IMicrosoftGraphChannel[]>]
      [-Classification <String>]
      [-CreatedDateTime <DateTime>]
      [-Description <String>]
      [-DisplayName <String>]
      [-FunSettings <IMicrosoftGraphTeamFunSettings>]
      [-Group <IMicrosoftGraphGroup>]
      [-GuestSettings <IMicrosoftGraphTeamGuestSettings>]
      [-Id <String>]
      [-IncomingChannels <IMicrosoftGraphChannel[]>]
      [-InstalledApps <IMicrosoftGraphTeamsAppInstallation[]>]
      [-InternalId <String>]
      [-IsArchived]
      [-MemberSettings <IMicrosoftGraphTeamMemberSettings>]
      [-Members <IMicrosoftGraphConversationMember[]>]
      [-MessagingSettings <IMicrosoftGraphTeamMessagingSettings>]
      [-Operations <IMicrosoftGraphTeamsAsyncOperation[]>]
      [-PermissionGrants <IMicrosoftGraphResourceSpecificPermissionGrant[]>]
      [-Photo <IMicrosoftGraphProfilePhoto>]
      [-PrimaryChannel <IMicrosoftGraphChannel>]
      [-Schedule <IMicrosoftGraphSchedule>]
      [-Specialization <String>]
      [-Summary <IMicrosoftGraphTeamSummary>]
      [-Tags <IMicrosoftGraphTeamworkTag[]>]
      [-Template <Hashtable>]
      [-TenantId <String>]
      [-Visibility <String>]
      [-WebUrl <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-MgTeam
      -TeamId <String>
      -BodyParameter <IMicrosoftGraphTeam>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-MgTeam
      -InputObject <ITeamsIdentity>
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-AllChannels <IMicrosoftGraphChannel[]>]
      [-Channels <IMicrosoftGraphChannel[]>]
      [-Classification <String>]
      [-CreatedDateTime <DateTime>]
      [-Description <String>]
      [-DisplayName <String>]
      [-FunSettings <IMicrosoftGraphTeamFunSettings>]
      [-Group <IMicrosoftGraphGroup>]
      [-GuestSettings <IMicrosoftGraphTeamGuestSettings>]
      [-Id <String>]
      [-IncomingChannels <IMicrosoftGraphChannel[]>]
      [-InstalledApps <IMicrosoftGraphTeamsAppInstallation[]>]
      [-InternalId <String>]
      [-IsArchived]
      [-MemberSettings <IMicrosoftGraphTeamMemberSettings>]
      [-Members <IMicrosoftGraphConversationMember[]>]
      [-MessagingSettings <IMicrosoftGraphTeamMessagingSettings>]
      [-Operations <IMicrosoftGraphTeamsAsyncOperation[]>]
      [-PermissionGrants <IMicrosoftGraphResourceSpecificPermissionGrant[]>]
      [-Photo <IMicrosoftGraphProfilePhoto>]
      [-PrimaryChannel <IMicrosoftGraphChannel>]
      [-Schedule <IMicrosoftGraphSchedule>]
      [-Specialization <String>]
      [-Summary <IMicrosoftGraphTeamSummary>]
      [-Tags <IMicrosoftGraphTeamworkTag[]>]
      [-Template <Hashtable>]
      [-TenantId <String>]
      [-Visibility <String>]
      [-WebUrl <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-MgTeam
      -InputObject <ITeamsIdentity>
      -BodyParameter <IMicrosoftGraphTeam>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update the properties of the specified team.

Permissions

Permission type	Least privileged permissions	Higher privileged permissions
Delegated (work or school account)	TeamSettings.ReadWrite.All	Directory.ReadWrite.All, Group.ReadWrite.All
Delegated (personal Microsoft account)	Not supported.	Not supported.
Application	TeamSettings.ReadWrite.Group	Directory.ReadWrite.All, Group.ReadWrite.All, TeamSettings.ReadWrite.All

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.Teams

$params = @{
	memberSettings = @{
		allowCreateUpdateChannels = $true
	}
	messagingSettings = @{
		allowUserEditMessages = $true
		allowUserDeleteMessages = $true
	}
	funSettings = @{
		allowGiphy = $true
		giphyContentRating = "strict"
	}
}

Update-MgTeam -TeamId $teamId -BodyParameter $params

This example shows how to use the Update-MgTeam Cmdlet.

Parameters

-AdditionalProperties

Additional Parameters

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

-AllChannels

List of channels either hosted in or shared with the team (incoming channels). To construct, see NOTES section for ALLCHANNELS properties and create a hash table.

Type:	IMicrosoftGraphChannel[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BodyParameter

team To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-Channels

The collection of channels and messages associated with the team. To construct, see NOTES section for CHANNELS properties and create a hash table.

Type:	IMicrosoftGraphChannel[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Classification

An optional label. Typically describes the data or business sensitivity of the team. Must match one of a pre-configured set in the tenant's directory.

Type:	String
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

-CreatedDateTime

Timestamp at which the team was created.

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

-Description

An optional description for the team. Maximum length: 1024 characters.

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

-DisplayName

The name of the team.

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

-FunSettings

teamFunSettings To construct, see NOTES section for FUNSETTINGS properties and create a hash table.

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

-Group

group To construct, see NOTES section for GROUP properties and create a hash table.

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

-GuestSettings

teamGuestSettings To construct, see NOTES section for GUESTSETTINGS properties and create a hash table.

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

-Headers

Optional headers that will be added to the request.

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

-Id

The unique identifier for an entity. Read-only.

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

-IncomingChannels

List of channels shared with the team. To construct, see NOTES section for INCOMINGCHANNELS properties and create a hash table.

Type:	IMicrosoftGraphChannel[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

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

-InstalledApps

The apps installed in this team. To construct, see NOTES section for INSTALLEDAPPS properties and create a hash table.

Type:	IMicrosoftGraphTeamsAppInstallation[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InternalId

A unique ID for the team that has been used in a few places such as the audit log/Office 365 Management Activity API.

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

-IsArchived

Whether this team is in read-only mode.

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

-Members

Members and owners of the team. To construct, see NOTES section for MEMBERS properties and create a hash table.

Type:	IMicrosoftGraphConversationMember[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MemberSettings

teamMemberSettings To construct, see NOTES section for MEMBERSETTINGS properties and create a hash table.

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

-MessagingSettings

teamMessagingSettings To construct, see NOTES section for MESSAGINGSETTINGS properties and create a hash table.

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

-Operations

The async operations that ran or are running on this team. To construct, see NOTES section for OPERATIONS properties and create a hash table.

Type:	IMicrosoftGraphTeamsAsyncOperation[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PermissionGrants

A collection of permissions granted to apps to access the team. To construct, see NOTES section for PERMISSIONGRANTS properties and create a hash table.

Type:	IMicrosoftGraphResourceSpecificPermissionGrant[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Photo

profilePhoto To construct, see NOTES section for PHOTO properties and create a hash table.

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

-PrimaryChannel

channel To construct, see NOTES section for PRIMARYCHANNEL properties and create a hash table.

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

-ProgressAction

Type:	ActionPreference
Aliases:	proga
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResponseHeadersVariable

Optional Response Headers Variable.

Type:	String
Aliases:	RHV
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Schedule

schedule To construct, see NOTES section for SCHEDULE properties and create a hash table.

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

-Specialization

teamSpecialization

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

-Summary

teamSummary To construct, see NOTES section for SUMMARY properties and create a hash table.

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

-Tags

The tags associated with the team. To construct, see NOTES section for TAGS properties and create a hash table.

Type:	IMicrosoftGraphTeamworkTag[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TeamId

The unique identifier of team

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

-Template

teamsTemplate

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

-TenantId

The ID of the Microsoft Entra tenant.

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

-Visibility

teamVisibilityType

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

-WebUrl

A hyperlink that will go to the team in the Microsoft Teams client. This is the URL that you get when you right-click a team in the Microsoft Teams client and select Get link to team. This URL should be treated as an opaque blob, and not parsed.

Type:	String
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

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphTeam

Microsoft.Graph.PowerShell.Models.ITeamsIdentity

System.Collections.IDictionary

Outputs