Get-VBRCloudSubUser

Short Description

Returns cloud subuser accounts.

Applies to

Platform: VMware, Hyper-V

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

Syntax

This cmdlet provides parameter sets that allow you to:

  • Get all cloud subusers.

Get-VBRCloudSubUser [-Mode <VBRCloudSubUserMode> {Common | AgentManagement}]  [<CommonParameters>]

  • Get cloud subusers by the subuser ID.

Get-VBRCloudSubUser [-Id <guid[]>] [-Mode <VBRCloudSubUserMode> {Common | AgentManagement}]  [<CommonParameters>]

  • Get cloud subusers by the subuser name.

Get-VBRCloudSubUser [-Name <string[]>] [-Mode <VBRCloudSubUserMode> {Common | AgentManagement}]  [<CommonParameters>]

  • Get cloud subusers by a cloud service provider.

Get-VBRCloudSubUser [-CloudProvider <VBRCloudProvider[]>] [-Mode <VBRCloudSubUserMode> {Common | AgentManagement}]  [<CommonParameters>]

Detailed Description

This cmdlet returns cloud subuser accounts of the following types:

  • Simple cloud subtenant accounts
  • vCD cloud 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

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

Id

Specifies an array of subuser ID. The cmdlet will return subusers with these IDs.

Guid[]

False

Named

True (ByValue,
ByProperty
Name)

Name

Specifies an array of names for subuser accounts. The cmdlet will return subusers with names.

String[]

False

Named

True (ByValue,
ByProperty
Name)

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

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.

False

Named

True (ByValue,
ByProperty
Name)

<CommonParameters>

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

Output Object

IVBRCloudSubUser

Examples

Get-VBRCloudSubUserExample 1. Getting All Cloud Subusers

This command returns all cloud subusers.

Get-VBRCloudSubUser

Get-VBRCloudSubUserExample 2. Getting Cloud Subuser by Name

This command looks for a subuser by the subuser name.

Get-VBRCloudSubUser -Name "Subuser 1"

Get-VBRCloudSubUserExample 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:

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

Related Commands

Get-VBRCloudProvider