diff --git a/teams/teams-ps/MicrosoftTeams/Get-TeamsArtifacts.md b/teams/teams-ps/MicrosoftTeams/Get-TeamsArtifacts.md new file mode 100644 index 0000000000..30fa619f85 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Get-TeamsArtifacts.md @@ -0,0 +1,121 @@ +--- +external help file: Microsoft.TeamsCmdlets.PowerShell.Custom.dll-Help.xml +Locale: en-US +Module Name: MicrosoftTeams +title: Get-TeamsArtifacts +author: lutingzhao +ms.author: lutingzhao +ms.date: 10/20/2025 +manager: bashe +online version: +schema: 2.0.0 +--- + +# Get-TeamsArtifacts + +## SYNOPSIS +The `Get-TeamsArtifacts` is available only to tenant administrators and is designed to export Recordings, Transcripts, Notes and Whiteboard artifacts of Teams Meetings. + +## SYNTAX +``` +Get-TeamsArtifacts [-OneDrive ] [-SharePoint] [-ArtifactType ] [-StartTime ] [-EndTime ] +``` + +## DESCRIPTION +This cmdlet exports Recordings, Transcripts, Notes and Whiteboard artifacts of Teams Meetings. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-TeamsArtifacts -OneDrive user@contoso.com -StartTime "2025-06-20" -EndTime "2025-06-26" +``` + +## PARAMETERS +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. + +### -OneDrive +Returns only artifacts that are hosted in the standard locations of that user's OneDrive for Business. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -SharePoint +Returns only the artifacts that are hosted in SharePoint sites (typically from channel meetings). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ArtifactType +Filters the results to a single artifact type. It's s Enum containing only three values: RecordingTranscript | Notes | Whiteboard. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: RecordingTranscript | Notes | Whiteboard +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -StartTime +Omits artifacts that are last modified prior to this date and time. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -EndTime +Omits artifacts that are last modified after this date and time. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +## OUTPUTS + +## NOTES + +## RELATED LINKS diff --git a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md index e6c4311b2e..65e03f63b4 100644 --- a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md +++ b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md @@ -587,6 +587,9 @@ This cmdlet supports retrieving incoming channels of a team. ### [Get-TeamsApp](Get-TeamsApp.md) Returns app information from the Teams tenant app store. +### [Get-TeamsArtifacts](Get-TeamsArtifacts.md) +Returns Recordings, Transcripts, Notes and Whiteboard artifacts of Teams Meetings. + ### [Get-TeamTargetingHierarchyStatus](Get-TeamTargetingHierarchyStatus.md) Get the status of a hierarchy upload.