Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Start-AzureStorSimpleBackupCloneJob

Start-AzureStorSimpleBackupCloneJob

microsoft.windowsazure.commands.storsimple.dll

Synopsis

Starts a job that clones a backup on a device.

Syntax

Start-AzureStorSimpleBackupCloneJob [-BackupId] [-Snapshot] [-CloneVolumeName] [-TargetAccessControlRecords] [-Force] [-Profile] [<CommonParameters>]

Start-AzureStorSimpleBackupCloneJob [-SourceDeviceName] [-TargetDeviceName] [-BackupId] [-Snapshot] [-CloneVolumeName] [-TargetAccessControlRecords] [-Force] [-Profile] [<CommonParameters>]

Start-AzureStorSimpleBackupCloneJob [-SourceDeviceId] [-TargetDeviceId] [-BackupId] [-Snapshot] [-CloneVolumeName] [-TargetAccessControlRecords] [-Force] [-Profile] [<CommonParameters>]

Detailed Description

The Start-AzureStorSimpleBackupCloneJob cmdlet starts a job that clones an existing backup on a StorSimple device.

Parameters

-BackupId <String>

Specifies the instance ID of the backup to clone.

Aliases

none

Required?

true

Position

3

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-CloneVolumeName <String>

Specifies the name for the new cloned volume on the target device.

Aliases

none

Required?

true

Position

5

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-Force <SwitchParameter>

Forces the command to run without asking for user confirmation.

Aliases

none

Required?

false

Position

7

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-Profile <AzureProfile>

Specifies an Azure profile.

Aliases

none

Required?

false

Position

named

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-Snapshot <Snapshot>

Specifies the snapshot object that this cmdlet clones.

Aliases

none

Required?

true

Position

4

Default value

none

Accept pipeline input?

true (ByValue)

Accept wildcard characters?

false

-SourceDeviceId <String>

Specifies the instance ID of the source device. This cmdlet clones the back from the source device.

Aliases

none

Required?

true

Position

1

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-SourceDeviceName <String>

Specifies the name of the source device. This cmdlet clones the back from the source device.

Aliases

none

Required?

true

Position

1

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-TargetAccessControlRecords <0, Culture=neutral, PublicKeyToken=null>

Specifies the access control records.

Aliases

none

Required?

false

Position

6

Default value

none

Accept pipeline input?

true (ByValue)

Accept wildcard characters?

false

-TargetDeviceId <String>

Specifies the instance ID of the target device.

Aliases

none

Required?

true

Position

2

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-TargetDeviceName <String>

Specifies the name of the device to which this cmdlet clones the backup.

Aliases

none

Required?

true

Position

2

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type

Snapshot, List of AccessControlRecord

Return Type


Notes

None

Examples

Example 1: Clone a backup to a different volume by using device names

The first command gets the first backup for the device named ContosoDev07 by using the Get-AzureStorSimpleDeviceBackup cmdlet. The command stores that backup in the $Backup variable.

The second command gets access control records by using the Get-AzureStorSimpleAccessControlRecord cmdlet. The command stores the result in the $Acrs variable.

The final command begins a job that clones a specified backup of a volume on a device to a different volume on the same device. This example specifies the device by name. The command uses the values stored in $Backup and $Acrs. The command returns the ID of the job.

PS C:\>$Backup = Get-AzureStorSimpleDeviceBackup -DeviceName "ContosoDev07" -First 1
PS C:\> $Acrs = Get-AzureStorSimpleAccessControlRecord -ACRName "Acr01"
PS C:\> Start-AzureStorSimpleBackupCloneJob -SourceDeviceName "ContosoDev07 -TargetDeviceName "ContosoDev07" -BackupId $Backup.InstanceId -Snapshot $Backup.Snapshots[0] -CloneVolumeName "cloned_volume11" -TargetAccessControlRecords $Acrs
VERBOSE: ClientRequestId: 43d8b4dc-39da-4ec5-92f6-be1f499155e9_PS
VERBOSE: ClientRequestId: be7a73a7-980c-4ba2-82d4-f6a7ee0eac0a_PS
VERBOSE: ClientRequestId: ee02aaae-d366-43d2-a229-8761d6db39f1_PS

Confirm
Are you sure you want to clone the backup with backupId fca748a0-4154-49e0-9550-07fa481cbd2d? 
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y
VERBOSE: ClientRequestId: 9b81d9f9-3e31-49be-a8cd-1b1c6afdb744_PS
bd05baee-36d0-48f4-8b1e-8119c4133446
VERBOSE: The start job is triggered successfully. Please use the command Get-AzureStorSimpleJob -InstanceId bd05baee-36d0-48f4-8b1e-8119c4133446 for tracking the job's status                        

Example 2: Clone a backup to a different volume by using device IDs

The first command gets the first backup for the device named ContosoDev07 by using the Get-AzureStorSimpleDeviceBackup cmdlet. The command stores that backup in the $Backup variable.

The second command gets access control records by using the Get-AzureStorSimpleAccessControlRecord cmdlet. The command stores the result in the $Acrs variable.

The final command begins a job that clones a specified backup of a volume on a device to a different volume on the same device. This example specifies the device by device ID. The command uses the values stored in $Backup and $Acrs. The command returns the ID of the job.

PS C:\>$Backup = Get-AzureStorSimpleDeviceBackup -DeviceName ContosoDev07 -First 1
PS C:\> $Acrs = Get-AzureStorSimpleAccessControlRecord -ACRName "Acr01"
PS C:\> Start-AzureStorSimpleBackupCloneJob -SourceDeviceId "be7a73a7-980c-4ba2-82d4-f6a7ee0eacbb" -TargetDeviceId "be7a73a7-980c-4ba2-82d4-f6a7ee0eacbb" -BackupId $Backup.InstanceId -Snapshot $Backup.Snapshots[0] -CloneVolumeName "cloned_volume11" -TargetAccessControlRecords $Acrs
VERBOSE: ClientRequestId: 43d8b4dc-39da-4ec5-92f6-be1f499155e9_PS
VERBOSE: ClientRequestId: be7a73a7-980c-4ba2-82d4-f6a7ee0eac0a_PS
VERBOSE: ClientRequestId: ee02aaae-d366-43d2-a229-8761d6db39f1_PS

Confirm
Are you sure you want to clone the backup with backupId fca748a0-4154-49e0-9550-07fa481cbd2d? 
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y
VERBOSE: ClientRequestId: 9b81d9f9-3e31-49be-a8cd-1b1c6afdb744_PS
bd05baee-36d0-48f4-8b1e-8119c4133446
VERBOSE: The start job is triggered successfully. Please use the command Get-AzureStorSimpleJob -InstanceId bd05baee-36d0-48f4-8b1e-8119c4133446 for tracking the job's status                        

Example 3: Clone a backup to a volume on a different device by using device names

The first command gets the first backup for the device named ContosoDev07 by using the Get-AzureStorSimpleDeviceBackup cmdlet. The command stores that backup in the $Backup variable.

The second command gets access control records by using the Get-AzureStorSimpleAccessControlRecord cmdlet. The command stores the result in the $Acrs variable.

The final command begins a job that clones a specified backup of a volume on a device to a volume on a different device. This example specifies the devices by name. The command uses the values stored in $Backup and $Acrs. The command returns the ID of the job.

PS C:\>$Backup = Get-AzureStorSimpleDeviceBackup -DeviceName "ContosoDev07" -First 1
PS C:\> $Acrs = Get-AzureStorSimpleAccessControlRecord -ACRName "Acr01"
PS C:\> Start-AzureStorSimpleBackupCloneJob -SourceDeviceName "ContosoDev07" -TargetDeviceName "ContosoDev12" -BackupId $Backup.InstanceId -Snapshot $Backup.Snapshots[0] -CloneVolumeName "cloned_volume11" -TargetAccessControlRecords $Acrs
VERBOSE: ClientRequestId: 43d8b4dc-39da-4ec5-92f6-be1f499155e9_PS
VERBOSE: ClientRequestId: be7a73a7-980c-4ba2-82d4-f6a7ee0eac0a_PS
VERBOSE: ClientRequestId: ee02aaae-d366-43d2-a229-8761d6db39f1_PS

Confirm
Are you sure you want to clone the backup with backupId fca748a0-4154-49e0-9550-07fa481cbd2d? 
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y
VERBOSE: ClientRequestId: 9b81d9f9-3e31-49be-a8cd-1b1c6afdb744_PS
bd05baee-36d0-48f4-8b1e-8119c4133446
VERBOSE: The start job is triggered successfully. Please use the command Get-AzureStorSimpleJob -InstanceId bd05baee-36d0-48f4-8b1e-8119c4133446 for tracking the job's status                        

Example 4: Clone a backup to a different volume by using device names and the pipeline operator

The first command gets the first backup for the device named ContosoDev07 by using the Get-AzureStorSimpleDeviceBackup cmdlet. The command stores that backup in the $Backup variable.

The second command gets access control records by using the Get-AzureStorSimpleAccessControlRecord cmdlet. The command passes its results to the current cmdlet by using the pipeline operator. The current cmdlet begins a job that clones a specified backup of a volume on a device, to a different volume on the same device. This example specifies the device by name. The command uses the value stored in $Backup. The command takes the value of the TargetAccessControlRecords parameter from the pipeline. The command returns the ID of the job.

PS C:\>$Backup = Get-AzureStorSimpleDeviceBackup -DeviceName ContosoDev1 -First 1
PS C:\> Get-AzureStorSimpleAccessControlRecord -ACRName acr1 | Start-AzureStorSimpleBackupCloneJob -SourceDeviceName ContosoDev1 -TargetDeviceName ContosoDev1 -BackupId $backup.InstanceId -Snapshot $backup.Snapshots[0] -CloneVolumeName "cloned_vol1" 
VERBOSE: ClientRequestId: 1183a29d-63a9-408a-9065-032c92d317ee_PS
VERBOSE: ClientRequestId: e195717c-5920-4133-bdf0-c1201ebabf6f_PS
VERBOSE: ClientRequestId: ac16644d-bfd8-4edf-b1ad-f5df4ceb4df7_PS
VERBOSE: ClientRequestId: dcdcab7f-2aaa-496d-8a18-2e7449a70227_PS
VERBOSE: ClientRequestId: 6f92e422-eda9-4087-aefb-2257a49f5beb_PS

Confirm
Are you sure you want to clone the backup with backupId fca748a0-4154-49e0-9550-07fa481cbd2d? 
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y
VERBOSE: ClientRequestId: 646b280c-b51c-4812-b5c5-b7ca215f1c90_PS
a747d2dc-2876-474e-aea6-6546b255427e
VERBOSE: The start job is triggered successfully. Please use the command Get-AzureStorSimpleJob -InstanceId a747d2dc-2876-474e-aea6-6546b255427e for tracking the job's status
VERBOSE: Access Control Record with given name acr11 is found!                        

Get-AzureStorSimpleDeviceBackup
Get-AzureStorSimpleAccessControlRecord