Edit

Share via

Get-TeamsArtifacts

Module:
MicrosoftTeams PowerShell module

The Get-TeamsArtifacts is available only to tenant administrators and is designed to export Recordings, Transcripts, Notes and Whiteboard artifacts of Teams Meetings. All parameters are optional. If no parameters are specified, artifact metadata is returned for Teams artifacts in all standard OneDrive for Business and SharePoint locations. The actual artifacts themselves can then be downloaded from the URLs in the metadata returned. Output is written to artifacts.json in the current directory.

Syntax

Default (Default) 

Get-TeamsArtifacts
    [-OneDrive <String>]
    [-SharePoint]
    [-ArtifactType <String>]
    [-StartTime <String>]
    [-EndTime <String>]
    [<CommonParameters>]

Description

This cmdlet exports Recordings, Transcripts, Notes and Whiteboard artifacts of Teams Meetings.

Examples

Example 1

PS C:\> Get-TeamsArtifacts -OneDrive user@contoso.com -StartTime "2025-06-20" -EndTime "2025-06-26"

Parameters

-ArtifactType

Filters the results to a single artifact type. It's s Enum containing only three values: RecordingTranscript | Notes | Whiteboard.

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

-EndTime

Omits artifacts that are last modified after this date and time.

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

-OneDrive

Returns only artifacts that are hosted in the standard locations of that user's OneDrive for Business.

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

-SharePoint

Returns only the artifacts that are hosted in SharePoint sites (typically from channel meetings).

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

-StartTime

Omits artifacts that are last modified prior to this date and time.

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

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.