This is an archive version of the document. To get the most up-to-date information, see the current version.

Get-VBRCloudTenant

Short Description

Returns cloud tenant accounts.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Requires a cloud provider license.

Syntax

This cmdlet provides 4 parameter sets.

  • For looking for all cloud tenants:

Get-VBRCloudTenant  [<CommonParameters>]

  • For looking for cloud tenant by ID:

Get-VBRCloudTenant [-Id <guid[]>]  [<CommonParameters>]

  • For looking for cloud tenants by name:

Get-VBRCloudTenant [-Name <string[]>]  [<CommonParameters>]

  • For looking for cloud tenants by a repository they use:

Get-VBRCloudTenant [-Repository <CBackupRepository[]>]  [<CommonParameters>]

Detailed Description

This cmdlet returns cloud tenant accounts.

You can get the list of all existing tenant accounts, search for instances directly by name or ID or get loud tenants accounts using a particular backup repository. Use an appropriate scenario for each case.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Id

Specifies the array of the IDs of the VBRCloudTenant object you want to get.

Accepts GUID or string type.

False

Named

True (by Value
FromPipeline, ValueFromPipeline
ByPropertyName)

False

Name

Specifies the array of the tenants names you want to get or search conditions.

False

Named

True (by Value
FromPipeline, ValueFromPipeline
ByPropertyName)

False

Repository

Specifies the array of backup repositories. The cmdlet will return the tenants that use these repositories.

Accepts CBackupRepository object.

You can specify simple or scale-out backup repositories.

You cannot specify cloud repositories.

False

Named

True (by Value
FromPipeline, ValueFromPipeline
ByPropertyName)

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Related Commands

Get-VBRBackupRepository

Return Type

VBRCloudTenant[]

Example 1

This command looks for all cloud tenants.

PS C:\PS> Get-VBRCloudTenant

Example 2

This command looks for a cloud tenant by name.

PS C:\PS> Get-VBRCloudTenant -Name "ABC Company"

Example 3

This command looks for the cloud tenants by backup repository.

Run Get-VBRBackupRepository to get the repository and pipe the result to Get-VBRCloudTenant.

PS C:\PS> Get-VBRBackupRepository -Name "Backups Vol2" | Get-VBRCloudTenant