Get-VBRCloudSubUser

Short Description

Returns cloud subuser accounts.

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides the following parameter sets:

AllParameterSets (Default)

Get-VBRCloudSubUser [-Mode <VBRCloudSubUserMode>] [<CommonParameters>]
Id

Get-VBRCloudSubUser [-Id <Guid[]>] [-Mode <VBRCloudSubUserMode>] [<CommonParameters>]
Name

Get-VBRCloudSubUser [-Name <String[]>] [-Mode <VBRCloudSubUserMode>] [<CommonParameters>]
CloudProvider

Get-VBRCloudSubUser [-CloudProvider <VBRCloudProvider[]>] [-Mode <VBRCloudSubUserMode>] [<CommonParameters>]

Detailed Description

This cmdlet returns cloud subuser accounts of the following types:

Simple cloud subtenant accounts
Cloud Director subtenant accounts

You can get the list of all existing subuser accounts, or narrow down the search results to name, ID or cloud provider. Use an appropriate parameter set for each case.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
CloudProvider	Specifies a cloud provider. The cmdlet will return subusers associated with this cloud provider. Accepts the `VBRCloudProvider[]` object. To get this object, run the `Get-VBRCloudProvider` cmdlet.	`VBRCloudProvider[]`	False	Named	True (ByPropertyName, ByValue)
Id	Specifies an array of subuser ID. The cmdlet will return subusers with these IDs.	`Guid[]`	False	Named	True (ByPropertyName, ByValue)
Mode	Specifies the cloud subtenant mode. You can select either of the following modes: `Common` `AgentManagement` The cmdlet will return subusers of the specified mode.	`VBRCloudSubUserMode`	False	Named	False
Name	Specifies an array of names for subuser accounts. The cmdlet will return subusers with names.	`String[]`	False	Named	True (ByPropertyName, ByValue)

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

IVBRCloudSubUser

Examples

Get-VBRCloudSubUser Example 1. Getting All Cloud Subusers

This command returns all cloud subusers.

Get-VBRCloudSubUser

Get-VBRCloudSubUser Example 2. Getting Cloud Subuser by Name

This command looks for a subuser by the subuser name.

Get-VBRCloudSubUser -Name "Subuser 1"

Get-VBRCloudSubUser Example 3. Getting Cloud Subuser by Cloud Service Provider

This example shows how to get a subuser by a cloud service provider.

$cloudProvider = Get-VBRCloudProvider

Get-VBRCloudSubUser -CloudProvider $cloudprovider

Perform the following steps:

Run the Get-VBRCloudProvider cmdlet. Save the result to the $cloudprovider variable.
Run the Get-VBRCloudSubUser cmdlet. Set the $cloudprovider variable as the CloudProvider parameter value.

Get-VBRCloudProvider