Short Description
Creates cloud tenant accounts.
Applies to
Platform: VMware, Hyper-V
Product Edition: Standard, Enterprise, Enterprise Plus
Requires a cloud provider license.
Syntax
Add-VBRCloudTenant -Name <string> -Password <string> [-Description <string>] [-EnableLeaseExpiration] [-LeaseExpirationDate <datetime>] [-Resources <VBRCloudTenantResource[]>] [-HashedPassword] [-EnableThrottling] [-ThrottlingValue <decimal>] [-ThrottlingUnit <VBRSpeedUnit> {MbitPerSec | MbytePerSec | KbytePerSec}] [-MaxConcurrentTask <int>] [-ReplicationResources <VBRCloudTenantReplicationResources>] [-EnableBackupProtection] [-BackupProtectionPeriod <int>] [<CommonParameters>] |
Detailed Description
This cmdlet creates a new cloud tenant account.
Parameters
Parameter | Description | Required | Position | Accept | Accept |
Name | Specifies the name you want to assign to the tenant account. The tenant name must meet the following requirements:
| True | Named | False | False |
Password | Specifies the password you want to set to the tenant account. | True | Named | False | False |
Description | Specifies the description of the tenant account. | False | Named | False | False |
Enable | Indicates that the tenant account must use lease expiration settings. Use LeaseExpirationDate parameter to set the lease expiration date. | False | Named | False | False |
Lease | Used to specify the lease expiration date for the EnableLeaseExpiration parameter. Accepts DateTime type. Default: 23:59:59.9999999, 31.12.9999. | False | Named | False | False |
Resources | Specifies the array of backup resource quotas you want to allocate to the tenant. You must set the Resources or the ReplicationResources parameter, or a combination of both, to create a tenant. Accepts VBRCloudTenantResource type. NOTE: When you assign multiple resource quotas to one tenant account, the resource quotas must have unique Repository Friendly Names and they must use different repositories. | False | Named | False | False |
Hashed | Indicates that you submit the hashed password. The hashed passwords are stored in Veeam backup database. Use this parameter, for example, to restore tenant accounts. | False | Named | False | False |
Enable | Indicates that the network throttling must be enabled to limit the maximum throughput of traffic. Use the ThrottlingValue and ThrottlingUnit parameters to set the maximum value. | False | Named | False | False |
Throttling | Used to set the value for the EnableThrottling parameter. Indicates the maximum throughput value. | False | Named | False | False |
Throttling | Used to set the value for the EnableThrottling parameter. Specifies the measure units for the ThrottlingValue parameter: MbitPerSec, MbytePerSec, KbytePerSec. Default: MbytePerSec. | False | Named | False | False |
MaxConcurrentTask | Specifies the maximum number of tasks the tenant can process in parallel. The number of tasks is the number of VM disks processed by one job targeted at the cloud repository or cloud host. | False | Named | False | False |
Replication | Allocates replication resources to the tenant. You must set the Resources or the ReplicationResources parameter, or a combination of both, to create a tenant. Accepts VBRCloudTenantReplicationResources type. | False | Named | False | False |
Enable | Indicates that tenant's backups must be protected from complete removal. With this option, tenant's deleted backups will be placed to the recycle bin on the service provider's side. The backups will be kept in the bin for the specified protection period. When this period ends, the backups are removed permanently. To specify the protection period, use the BackupProtectionPeriod parameter. | False | Named | False | False |
BackupProtection | Used to set the time period for the EnableBackupProtection parameter. Can be set to 1-99 days. | False | Named | False | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.
Return Type
Example 1
This command adds a tenant with backup resources and lease expiration settings enabled.
- Pre-configure backup resources. For details, see New-VBRCloudTenantResource. Save the result to the '$backupresources' variable.
- Run Add-VBRCloudTenant and set the tenant name, password, description and lease period. Use the '$backupresources' variable to assign backup resources to the tenant.
PS C:\PS> Add-VBRCloudTenant -Name "ABC Company" -Description "User account for ABC company" -EnableLeaseExpiration -LeaseExpirationDate "12/30/2017" -Password "Pass123" -Resources $backupresources |
Example 2
This command adds a tenant with backup and replication resources.
- Pre-configure backup resources. For details, see New-VBRCloudTenantResource. Save the result to the '$backupresources' variable.
- Pre-configure replication resources. For details, see New-VBRCloudTenantReplicationResources. Save the result to the '$replicationresources' variable.
- Run Add-VBRCloudTenant and set the tenant name, password and description. Use the '$backupresources' variable and the '$replicationresources' variable to assign resources to the tenant.
PS C:\PS> Add-VBRCloudTenant -Name "ABC Company" -Description "User account for ABC company" -Password "Pass123" -Resources $backupresources -ReplicationResources $replicationresources |
Related Commands