Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

New-AzRestorePoint

This cmdlet can create a New Restore Point

Syntax

Default (Default) 

New-AzRestorePoint
 [-ResourceGroupName] <String>
 [-RestorePointCollectionName] <String>
 [-Name] <String>
 [[-Location] <String>]
 [-RestorePointId <String>]
 [-DisksToExclude <String[]>]
 [-ConsistencyMode <String>]
 [-InstantAccessDurationInMinutes <Int32>]
 [-DefaultProfile <IAzureContextContainer>]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

Description

Create's a new Restore Point

Examples

Example 1

New-AzRestorePoint -ResourceGroupName "myRG" -RestorePointCollectionName "myCollection" -Name "myRestorePoint" -ConsistencyMode "CrashConsistent"

Creates a new Restore Point

Example 2

New-AzRestorePoint -ResourceGroupName "MyResourceGroup" -RestorePointCollectionName "MyRPCollection" -Name "MyRestorePoint" -InstantAccessDurationInMinutes 120

Creates a new application-consistent Restore Point with a 120-minute instant access snapshot duration.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

-ConsistencyMode

ConsistencyMode of the restore point. Can be specified in the input while creating a restore point. For now, only CrashConsistent is accepted as a valid input. Please refer to https://aka.ms/RestorePoints for more details.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-DefaultProfile

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

Parameter properties

Type:IAzureContextContainer
Default value:None
Supports wildcards:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Parameter sets

-DisksToExclude

List of disk resource Id values that the customer wishes to exclude from the restore point. If no disks are specified, all disks will be included.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-InstantAccessDurationInMinutes

Duration in minutes for which the instant access snapshot is retained. Valid range: 1 to 300. Only applicable when the parent restore point collection has InstantAccess enabled.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Location

Set the region of the restore point

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-Name

The name of the restore point

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:RestorePointName

Parameter sets

-ResourceGroupName

Resource group name this resource belongs to

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-RestorePointCollectionName

Name of the restore point collection this restore point is part of

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-RestorePointId

ARM Id of the source restore point

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

String

String

Outputs

Microsoft.Azure.Commands.Compute.Automation.Models.PSRestorePoint

Feedback

Was this page helpful?