< Back
New-AzureRmBackupVault
Post
NAME New-AzureRmBackupVault
SYNOPSIS
Creates a Backup vault.
SYNTAX
New-AzureRmBackupVault [-ResourceGroupName] <String> [-Name] <String> [-Region] <String> [[-Storage] {GeoRedundant | LocallyRedundant}]
[-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.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
Specifies a name for the Azure Backup vault. The name must be unique in a resource group.
Required? true
Position? 1
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Region <String>
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.
Required? true
Position? 2
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ResourceGroupName <String>
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.
Required? true
Position? 0
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Storage <AzureBackupVaultStorageType>
Specifies the storage type for the backup data. The acceptable values for this parameter are: LocallyRedundant and GeoRedundant. The default
value is GeoRedundant.
Required? false
Position? 3
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
OUTPUTS
AzureRmBackupVault
NOTES
* None
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.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... ackupvault
Get-AzureRmBackupVault
Remove-AzureRmBackupVault
Set-AzureRmBackupVault
SYNOPSIS
Creates a Backup vault.
SYNTAX
New-AzureRmBackupVault [-ResourceGroupName] <String> [-Name] <String> [-Region] <String> [[-Storage] {GeoRedundant | LocallyRedundant}]
[-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.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
Specifies a name for the Azure Backup vault. The name must be unique in a resource group.
Required? true
Position? 1
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Region <String>
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.
Required? true
Position? 2
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ResourceGroupName <String>
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.
Required? true
Position? 0
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Storage <AzureBackupVaultStorageType>
Specifies the storage type for the backup data. The acceptable values for this parameter are: LocallyRedundant and GeoRedundant. The default
value is GeoRedundant.
Required? false
Position? 3
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
OUTPUTS
AzureRmBackupVault
NOTES
* None
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.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... ackupvault
Get-AzureRmBackupVault
Remove-AzureRmBackupVault
Set-AzureRmBackupVault