Edit

Share via

Get-AzRecoveryServicesBackupProtectionPolicy

  • Reference
Module:
Az.RecoveryServices

Gets Backup protection policies for a vault.

Syntax

PowerShell 
Get-AzRecoveryServicesBackupProtectionPolicy
   [-IsArchiveSmartTieringEnabled <Boolean>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-PolicySubType <PSPolicyType>]
   [<CommonParameters>]
PowerShell 
Get-AzRecoveryServicesBackupProtectionPolicy
   [-Name] <String>
   [-IsArchiveSmartTieringEnabled <Boolean>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-PolicySubType <PSPolicyType>]
   [<CommonParameters>]
PowerShell 
Get-AzRecoveryServicesBackupProtectionPolicy
   [-WorkloadType] <WorkloadType>
   [-IsArchiveSmartTieringEnabled <Boolean>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-PolicySubType <PSPolicyType>]
   [<CommonParameters>]
PowerShell 
Get-AzRecoveryServicesBackupProtectionPolicy
   [-WorkloadType] <WorkloadType>
   [-BackupManagementType] <BackupManagementType>
   [-IsArchiveSmartTieringEnabled <Boolean>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-PolicySubType <PSPolicyType>]
   [<CommonParameters>]

Description

The Get-AzRecoveryServicesBackupProtectionPolicy cmdlet gets Azure Backup protection policies for a vault. Set the vault context by using the Set-AzRecoveryServicesVaultContext cmdlet before you use the current cmdlet.

Examples

Example 1: Get all policies in the vault

PowerShell 
Get-AzRecoveryServicesBackupProtectionPolicy

Name                 WorkloadType       BackupManagementType BackupTime                DaysOfWeek   
----                 ------------       -------------------- ----------                ----------   
DefaultPolicy        AzureVM            AzureVM              4/14/2016 5:00:00 PM                   
NewPolicy            AzureVM            AzureVM              4/23/2016 5:30:00 PM                   
NewPolicy2           AzureVM            AzureVM              4/24/2016 1:30:00 AM

This command gets all protection policies created in the vault.

Example 2: Get a specific policy

PowerShell 
$Pol= Get-AzRecoveryServicesBackupProtectionPolicy -Name "DefaultPolicy"

This command gets the protection policy named DefaultPolicy, and then stores it in the $pol variable.

Example 3: Get only Enhanced policies in a vault

PowerShell 
$pol = Get-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -BackupManagementType AzureVM -WorkloadType AzureVM  -PolicySubType Enhanced

This command gets only the Enhanced protection policies in RS vault, and then stores it in the $pol variable.

Example 4: Get smart tiering enabled policies in a vault

PowerShell 
$pol = Get-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -BackupManagementType AzureVM -WorkloadType AzureVM  -IsArchiveSmartTieringEnabled $true

This command gets only the policies in RS vault for which archive smart tiering is enabled. To fetch the policies for which smart tiering is disabled, set IsArchiveSmartTieringEnabled parameter to $false. To fetch all the polcies, skip this parameter.

Parameters

-BackupManagementType

The class of resources being protected. Currently the values supported for this cmdlet are AzureVM, AzureStorage, AzureWorkload

Type:Nullable<T>[BackupManagementType]
Accepted values:AzureVM, SCDPM, AzureBackupServer, AzureStorage, AzureWorkload, MAB
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

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

-IsArchiveSmartTieringEnabled

Parameter to list policies for which smart tiering is Enabled/Disabled. Allowed values are $true, $false.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the name of the policy.

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

-PolicySubType

Type of policy to be fetched: Standard, Enhanced

Type:PSPolicyType
Accepted values:Standard, Enhanced
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultId

ARM ID of the Recovery Services Vault.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WorkloadType

Workload type of the resource. The current supported values are AzureVM, AzureFiles, MSSQL

Type:Nullable<T>[WorkloadType]
Accepted values:AzureVM, AzureSQLDatabase, AzureFiles, MSSQL
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Outputs