New-AzureRmBackupVault

Creates a Backup vault.

Warning

The AzureRM PowerShell module has been officially deprecated as of February 29, 2024. Users are advised to migrate from AzureRM to the Az PowerShell module to ensure continued support and updates.

Although the AzureRM module may still function, it's no longer maintained or supported, placing any continued use at the user's discretion and risk. Please refer to our migration resources for guidance on transitioning to the Az module.

Syntax

New-AzureRmBackupVault
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Region] <String>
   [[-Storage] <AzureBackupVaultStorageType>]
   [-DefaultProfile <IAzureContextContainer>]
   [<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.

Parameters

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with azure

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:1
Default value:None
Required:True
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:2
Default value:None
Required:True
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:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-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
Accepted values:GeoRedundant, LocallyRedundant
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

AzureRMBackupVault

Notes

  • None