New-​Azure​Rm​Backup​Vault

Creates a Backup vault.

Syntax

New-AzureRmBackupVault
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Region] <String>
   [[-Storage] <AzureBackupVaultStorageType>]
   [<CommonParameters>]

Description

The New-AzureRmBackupVault cmdlet creates an Azure Backup vault. This cmdlet returns an AzureRmBackupVault object that acts as a reference to the vault entity.

Examples

Example 1: Create a backup vault

PS C:\>New-AzureRmBackupVault -ResourceGroupName "ResourceGroup01" -Name "Vault03" -Region "westus"
ResourceId        : /subscriptions/4bfbe168-f42a-4a06-8f5a-331cad1f497e/resourceGroups/ResourceGroup01/providers/Microsoft.Backup
                    /BackupVault/Vault03
Name              : Vault03
ResourceGroupName : ResourceGroup01
Region            : westus
Storage           : GeoRedundant

This command creates an Azure Backup vault named Vault03. The vault is in the resource group named ResourceGroup01 in the West US region. The vault uses the default GeoRedundant storage type.

Example 2: Create a backup vault that uses locally redundant storage

PS C:\>New-AzureRmBackupVault -ResourceGroupName "ResourceGroup02" -Name "Vault03" -Region "westus" -Storage LocallyRedundant
ResourceId        : /subscriptions/4bfbe168-f42a-4a06-8f5a-331cad1f497e/resourceGroups/ResourceGroup02/providers/Microsoft.Backup
                    /BackupVault/Vault03
Name              : Vault03
ResourceGroupName : ResourceGroup02
Region            : westus
Storage           : LocallyRedundant

This command creates an Azure Backup vault named Vault03. The vault is in the resource group named ResourceGroup02 in the West US region. The vault uses the LocallyRedundant storage type.

Required Parameters

-Name

Specifies a name for the Azure Backup vault. The name must be unique in a resource group.

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Region

Specifies an Azure region in which the backup vault exists. For hybrid backup scenarios, we recommend that you create a vault in a region close to the on-premise server to reduce latency. For backup of Azure infrastructure as a service (IaaS) virtual machines, the vault becomes the point of discovery for local virtual machines.

Type:String
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ResourceGroupName

Specifies the name of an existing Azure resource group in which this cmdlet creates a Backup vault. To create a resource group, use the New-AzureRMResourceGroup cmdlet. The resource group and the Azure Backup vault do not have to be in the same region.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Storage

Specifies the storage type for the backup data. The acceptable values for this parameter are: LocallyRedundant and GeoRedundant. The default value is GeoRedundant.

Type:AzureBackupVaultStorageType
Parameter Sets:GeoRedundant, LocallyRedundant
Position:4
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

AzureRmBackupVault

Notes

  • None