New-AzureSiteRecoveryProtectionProfileObject

Creates a Site Recovery protection profile object.

Note

The cmdlets referenced in this documentation are for managing legacy Azure resources that use Azure Service Manager (ASM) APIs. This legacy PowerShell module isn't recommended when creating new resources since ASM is scheduled for retirement. For more information, see Azure Service Manager retirement.

The Az PowerShell module is the recommended PowerShell module for managing Azure Resource Manager (ARM) resources with PowerShell.

Syntax

New-AzureSiteRecoveryProtectionProfileObject
   [-Name <String>]
   -ReplicationProvider <String>
   -RecoveryAzureSubscription <String>
   -RecoveryAzureStorageAccount <String>
   -ReplicationFrequencyInSeconds <String>
   [-RecoveryPoints <Int32>]
   [-ApplicationConsistentSnapshotFrequencyInHours <Int32>]
   [-ReplicationStartTime <TimeSpan>]
   [-Force]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-AzureSiteRecoveryProtectionProfileObject
   [-Name <String>]
   -ReplicationProvider <String>
   [-ReplicationMethod <String>]
   -ReplicationFrequencyInSeconds <String>
   [-RecoveryPoints <Int32>]
   [-ApplicationConsistentSnapshotFrequencyInHours <Int32>]
   [-CompressionEnabled]
   -ReplicationPort <UInt16>
   [-Authentication <String>]
   [-ReplicationStartTime <TimeSpan>]
   [-AllowReplicaDeletion]
   [-Force]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

The New-AzureSiteRecoveryProtectionProfileObject cmdlet creates an Azure Site Recovery protection profile object. This cmdlet creates an ASRProtectionProfile object to use with other cmdlets.

Examples

Example 1: Create a protection profile

PS C:\> New-AzureSiteRecoveryProtectionProfileObject -ReplicationProvider "HyperVReplica" -AllowReplicaDeletion -ApplicationConsistentSnapshotFrequencyInHours 1 -CompressionEnabled -RecoveryPoints 2 -ReplicationFrequencyInSeconds 30 -ReplicationMethod "Online" -ReplicationPort 8085 -ReplicationStartTime 1
Name                                     : 
ID                                       : 
ReplicationProvider                      : HyperVReplica
HyperVReplicaProviderSettingsObject      : Microsoft.Azure.Portal.RecoveryServices.Models.Common.HyperVReplicaProviderSettings
HyperVReplicaAzureProviderSettingsObject :

This command creates a protection profile object.

Example 2: Create a protection profile for HyperVReplicaAzure provider

PS C:\> New-AzureSiteRecoveryProtectionProfileObject -Name "ProtectionProfile" -ReplicationProvider "HyperVReplicaAzure" -RecoveryAzureSubscription "cb53d0c3-bd59-4721-89bc-06916a9147ef" -RecoveryAzureStorageAccount "Contoso01" -ReplicationFrequencyInSeconds 30 -RecoveryPoints 1 -Force
Name                                     : ProtectionProfile
ID                                       : 
ReplicationProvider                      : HyperVReplicaAzure
HyperVReplicaProviderSettingsObject      : 
HyperVReplicaAzureProviderSettingsObject : Microsoft.Azure.Portal.RecoveryServices.Models.Common.HyperVReplicaAzureProviderSettings

This command creates a protection profile for a HyperVReplicaAzure provider.

Parameters

-AllowReplicaDeletion

Indicates that the protection profile enables deletion of replica entities.

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

-ApplicationConsistentSnapshotFrequencyInHours

Specifies the frequency, in hours, for application consistent snapshots.

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

-Authentication

Specifies the type of authentication to use. The acceptable values for this parameter are: Certificate and Kerberos.

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

-CompressionEnabled

Indicates that the protection profile enables compression.

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

-Force

Forces the command to run without asking for user confirmation.

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

-Name

Specifies a name for the protection profile.

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

-Profile

Specifies the Azure profile from which this cmdlet reads. If you do not specify a profile, this cmdlet reads from the local default profile.

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

-RecoveryAzureStorageAccount

Specifies the name of an Azure Storage account on which to store the Azure replica entity.

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

-RecoveryAzureSubscription

Specifies the ID for an Azure Subscription for a storage account. This parameter refers to the account on which to store the Azure replica entity.

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

-RecoveryPoints

Specifies the number of hours to retain recovery points.

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

-ReplicationFrequencyInSeconds

Specifies the frequency interval, in seconds, for replication. The acceptable values for this parameter are:

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

-ReplicationMethod

Specifies the replication method. The acceptable values for this parameter are:

  • Online. Replication over the network.
  • Offline.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReplicationPort

Specifies the number of the port on which the replication occurs.

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

-ReplicationProvider

Specifies the type of replication provider. The acceptable values for this parameter are: HyperVReplica and HyperVReplicaAzure.

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

-ReplicationStartTime

Specifies the start time of the replication. Specify a time within 24 hours after you start the job.

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