Get-VBRGoogleCloudBucket

Short Description

Returns Google Cloud buckets.

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

Syntax

Get-VBRGoogleCloudBucket -Connection <IVBRGoogleCloudConnection> -Region <VBRGoogleCloudRegion[]>

[-Name <String[]>] [<CommonParameters>]

Detailed Description

This cmdlet returns an array of Google Cloud buckets.

Important

To be able to get a list of all buckets, you must configure the storage.buckets.list permission.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Connection	Specifies an active session with Google Cloud object storage. The cmdlet will return an array of Google Cloud buckets for this Google Cloud object storage. Accepts the `VBRGoogleCloudConnection` object. To create this object, run the `Connect-VBRGoogleCloudService` cmdlet.	`IVBRGoogleCloudConnection`	True	Named	True (ByPropertyName, ByValue)
Name	Specifies a name of the Google Cloud bucket. The cmdlet will return the bucket with this name. Note: If you do not have permissions to get all buckets, the cmdlet will not return the necessary bucket.	`String[]`	False	Named	False
Region	Specifies an array of Google Cloud regions where Google Cloud buckets are located. The cmdlet will return an array of Google Cloud buckets from these Google Cloud regions. Accepts the `VBRGoogleCloudRegion[]` object. To create this object, run the `Get-VBRGoogleCloudRegion` cmdlet.	`VBRGoogleCloudRegion[]`	True	Named	False

<CommonParameters>

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

Output Object

The cmdlet returns the VBRGoogleCloudBucket object that contains an array of Google Cloud buckets.

Examples

Getting Array of Google Cloud Buckets within Region

This example shows how to get an array of all Google Cloud buckets from a particular Google Cloud region.

$account = Get-VBRGoogleCloudAccount -Id "936edf7c-7cf3-4ddc-9895-c7485ef4bb2c"

$connection = Connect-VBRGoogleCloudService -Account $account -ServiceType CapacityTier

$region = Get-VBRGoogleCloudRegion -Connection $connection

Get-VBRGoogleCloudBucket -Connection $connection -Region $region

Perform the following steps:

Run the Get-VBRGoogleCloudAccount cmdlet. Specify the Id parameter value. Save the result to the $account variable.
Run the Connect-VBRGoogleCloudService cmdlet. Specify the Account and ServiceType parameter values. Save the result to the $connection variable.
Run the Get-VBRGoogleCloudRegion cmdlet. Specify the Connection parameter value. Save the result to the $region variable.
Run the Get-VBRGoogleCloudBucket cmdlet. Specify the following settings:
- Set the $connection variable as the Connection parameter value.
- Set the $region variable as the Region parameter value.