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
Notes
- None