Get-VETPost
Returns Microsoft Teams team channel posts.
Veeam Backup for Microsoft 365
Product Edition: Community, Rental License, Subscription License
This cmdlet provides parameter sets that allow you to:
- Get posts from a channel.
Get-VETPost -Channel <VETChannel> [-Query <String>] [-Recurse] [<CommonParameters>] |
- Get posts under the specified parent post.
Get-VETPost -ParentPost <VETPost> [-Query <String>] [-Recurse] [<CommonParameters>] |
- Get posts from an organization.
Get-VETPost [-Query <String>] -Organization <VETOrganization[]> [<CommonParameters>] |
Get-VETPost [-Query <String>] -Team <VETTeam> [<CommonParameters>] |
This cmdlet returns posts published in Microsoft Teams team channels. You can get parent and child posts from the following backed-up sources:
- Microsoft 365 organization
- Microsoft Teams team
- Microsoft Teams channel
Parameter | Description | Type | Required | Position | Accept Pipeline Input |
|---|
Channel | Specifies a Microsoft Teams team channel. The cmdlet will return posts from this channel. | Accepts the VETChannel object. To get this object, run the Get-VETChannel cmdlet. | True | Named | True (ByValue) |
Query | Specifies a query string for post search. The cmdlet will return posts that match the search query from the specified organization, team, channel or parent post. | String | False | Named | False |
Recurse | Defines that the cmdlet will return the specified parent post and all of its child posts. Default: False | SwitchParameter | False | Named | False |
ParentPost | Specifies a parent post. The cmdlet will return child posts of this parent post. | Accepts the VETPost object. To get this object, run the Get-VETPost cmdlet. | True | Named | True (ByValue) |
Organization | Specifies an array of Microsoft Teams organizations. The cmdlet will return posts from these organizations. | Accepts the VETOrganization[] object. To get this object, run the Get-VETOrganization cmdlet. | True | Named | True (ByValue) |
Team | Specifies a Microsoft Teams team. This cmdlet will return posts from this team. | Accepts the VETTeam object. To get this object, run the Get-VETTeam cmdlet. | True | Named | True (ByValue) |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.
The cmdlet returns the VETPost[] array that contains Microsoft Teams posts.
This example shows how to get all posts from the General channel. $session = Get-VBOTeamsItemRestoreSession $org = Get-VETOrganization -Session $session -Name "ABC*" $team = Get-VETTeam -Organization $org -DisplayName "IT" $channel = Get-VETChannel -Team $team -DisplayName "General" Get-VETPost -Channel $channel |
Perform the following steps: - Get the channel:
- Run the Get-VBOTeamsItemRestoreSession cmdlet. Save the result to the $session variable.
- Run the Get-VETOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Use the * wildcard character to substitute the timestamp. Save the result to the $org variable.
- Run the Get-VETTeam cmdlet. Set the $org variable as the Organization parameter value. Specify the DisplayName parameter value. Save the result to the $team variable.
- Run the Get-VETChannel cmdlet. Set the $team variable as the Team parameter value. Specify the DisplayName parameter value. Save the result to the $channel variable.
- Run the Get-VETPost cmdlet. Set the $channel variable as the Channel parameter value.
|
This example shows how to get channel posts under the Announcement parent post. $session = Get-VBOTeamsItemRestoreSession $org = Get-VETOrganization -Session $session -Name "ABC*" $post = Get-VETPost -Organization $org -Query "subject: announcement" Get-VETPost -ParentPost $post |
Perform the following steps: - Get the parent post:
- Run the Get-VBOTeamsItemRestoreSession cmdlet. Save the result to the $session variable.
- Run the Get-VETOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Use the * wildcard character to substitute the timestamp. Save the result to the $org variable.
- Run the Get-VETPost cmdlet. Set the $org variable as the Organization parameter value. Specify the Query parameter value. Save the result to the $post variable.
- Run the Get-VETPost cmdlet. Set the $post variable as the ParentPost parameter value.
|
This example shows how to get channel posts from the ABC organization. $session = Get-VBOTeamsItemRestoreSession $org = Get-VETOrganization -Session $session -Name "ABC*" Get-VETPost -Organization $org |
Perform the following steps: - Get the organization:
- Run the Get-VBOTeamsItemRestoreSession cmdlet. Save the result to the $session variable.
- Run the Get-VETOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Use the * wildcard character to substitute the timestamp. Save the result to the $org variable.
- Run the Get-VETPost cmdlet. Set the $org variable as the Organization parameter value.
|
This example shows how to get channel posts from the IT team. $session = Get-VBOTeamsItemRestoreSession $org = Get-VETOrganization -Session $session -Name "ABC*" $team = Get-VETTeam -Organization $org -DisplayName "IT" Get-VETPost -Team $team |
Perform the following steps: - Get the team:
- Run the Get-VBOTeamsItemRestoreSession cmdlet. Save the result to the $session variable.
- Run the Get-VETOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Use the * wildcard character to substitute the timestamp. Save the result to the $org variable.
- Run the Get-VETTeam cmdlet. Set the $org variable as the Organization parameter value. Specify the DisplayName parameter value. Save the result to the $team variable.
- Run the Get-VETPost cmdlet. Set the $team variable as the Team parameter value.
|
Related Commands
Example 1. Getting Posts from Channel