Get-AzureStorSimpleDeviceBackup

Gets backups from a device.

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

Get-AzureStorSimpleDeviceBackup
   -DeviceName <String>
   [-From <String>]
   [-To <String>]
   [-First <Int32>]
   [-Skip <Int32>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureStorSimpleDeviceBackup
   -DeviceName <String>
   -BackupPolicyId <String>
   [-From <String>]
   [-To <String>]
   [-First <Int32>]
   [-Skip <Int32>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureStorSimpleDeviceBackup
   -DeviceName <String>
   -VolumeId <String>
   [-From <String>]
   [-To <String>]
   [-First <Int32>]
   [-Skip <Int32>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureStorSimpleDeviceBackup
   -DeviceName <String>
   -BackupPolicy <BackupPolicyDetails>
   [-From <String>]
   [-To <String>]
   [-First <Int32>]
   [-Skip <Int32>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureStorSimpleDeviceBackup
   -DeviceName <String>
   -Volume <VirtualDisk>
   [-From <String>]
   [-To <String>]
   [-First <Int32>]
   [-Skip <Int32>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

The Get-AzureStorSimpleDeviceBackup cmdlet gets backups from a device. You can specify the backup policy, volume, and creation time for backups.

This cmdlet can return a maximum of 100 backups in the first page. If more than 100 backups exist, retrieve subsequent pages by using the First and Skip parameters. If you specify a value of 100 for Skip and 50 for First, this cmdlet does not return the first 100 results. It returns the next 50 results after the 100 that it skips.

Examples

Example 1: Get all backups on a device

PS C:\>Get-AzureStorSimpleDeviceBackup -DeviceName "Contoso63-AppVm"
InstanceId                           Name                               Type          BackupJobCreationType              CreatedOn                          SizeInBytes                       Snapshots                         SSMHostName                      
----------                           ----                               ----          ---------------------              ---------                          -----------                       ---------                         -----------                      
85074062-ef6a-408a-b6c9-2a0904bb99ca Snapshot_vg-all                    LocalSnapshot BySchedule                         4/15/2015 1:30:02 PM               9375913607168                     {Volume 1, Volume 4, Volume 3,                                     
                                                                                                                                                                                              Volume 2}                                                          
ebd87fa3-a9e2-49c9-a7e6-dada47071544 Cloud_Snapshot_vg-all              CloudSnapshot BySchedule                         4/15/2015 11:30:02 AM              9375913607168                     {Volume 1, Volume 4, Volume 3,                                     
                                                                                                                                                                                              Volume 2}                                                          
9f7a03be-8c39-474c-bf88-b2c7b54e833c Cloud_Snapshot_Vol3_clone VG       CloudSnapshot BySchedule                         4/15/2015 9:00:03 AM               1717986918400                     {Volume 3 Clone}                                                   
177b2dad-c0b2-42d6-b7bb-16926e54e9c6 VG Clones                          CloudSnapshot BySchedule                         4/15/2015 8:30:02 AM               5016521801728                     {Volume 1 Clone, Volume 3 Clone}                                   
49c470c0-eadb-40ac-9928-94018a8edcd4 Cloud_Snapshot_Vol1_clone VG       CloudSnapshot BySchedule                         4/15/2015 7:30:02 AM               3298534883328                     {Volume 1 Clone}                                                   
45dfd283-f924-4b45-93eb-b20650cadf43 vg-all                             LocalSnapshot Adhoc                              3/27/2015 9:12:15 PM               9375913607168                     {Volume 1, Volume 4, Volume 3,                                     
                                                                                                                                                                                              Volume 2}                                                          
2c3dd48d-824c-4298-82b5-fb44abb67a1e Test Group                         LocalSnapshot Adhoc                              3/27/2015 1:47:00 AM               5016521801728                     {Volume 1, Volume 3}

This command gets all backups that exist on the device named Contoso63-AppVm. If there are more than the maximum of 100 backups allowed for the first page, use the First and Skip parameters to view additional results.

Example 2: Get backups created between two dates

PS C:\>Get-AzureStorSimpleDeviceBackup -DeviceName "Contoso63-AppVm" -From "9/7/2014" -To "10/7/2014" -First 2 -Skip 1
BackupJobCreationType : BySchedule
CreatedOn             : 10/5/2014 11:00:04 AM
SizeInBytes           : 10737418240
Snapshots             : {ContosoTSQA}
SSMHostName           : 
Type                  : CloudSnapshot
InstanceId            : ec2fdf5c-c807-4f7b-a942-d4c4a9b68c44
Name                  : ContosoTSQA_Default
BackupJobCreationType : BySchedule
CreatedOn             : 10/4/2014 11:00:06 AM
SizeInBytes           : 10737418240
Snapshots             : {ContosoTSQA}
SSMHostName           : 
Type                  : CloudSnapshot
InstanceId            : 5ac4f947-f4c6-4770-9000-2242e72fc6d3
Name                  : ContosoTSQA_DefaultVERBOSE: # of backups returned : 2
VERBOSE: More backups are available for your query. To access the next page of your result use \"-First 2 -Skip 3\" in
your commandlet

This command gets backups on the device named Contoso63-AppVm that were created on or after 10/7/2014 and on or before 10/8/2014. This cmdlet skips the first result and returns the first two results after that first result. Modify values for First and Skip to view other results.

Example 3: Get backups for a backup policy ID

PS C:\>Get-AzureStorSimpleDeviceBackup -DeviceName "Contoso63-AppVm" -BackupPolicyId "00001111-aaaa-2222-bbbb-3333cccc4444" -First 10 -From "9/7/2014"
BackupJobCreationType : BySchedule
CreatedOn             : 10/1/2014 11:00:12 AM
SizeInBytes           : 10737418240
Snapshots             : {ContosoTSQA}
SSMHostName           : 
Type                  : CloudSnapshot
InstanceId            : e1aec9f1-a321-443f-a058-ba78c749c2c2
Name                  : ContosoTSQA_Default
....... 

BackupJobCreationType : BySchedule
CreatedOn             : 9/29/2014 11:00:12 AM
SizeInBytes           : 10737418240
Snapshots             : {ContosoTSQA}
SSMHostName           : 
Type                  : CloudSnapshot
InstanceId            : f8041928-37b9-4048-a99c-2d3078943874
Name                  : ContosoTSQA_Default
VERBOSE: # of backups returned : 10
VERBOSE: More backups are available for your query. To access the next page of your result use \"-First 10 -Skip 10\"
in your commandlet

This command gets backups on the device named Contoso63-AppVm created on or before the specified date. The command gets backups that were created by using the backup policy that has the specified ID. This command specifies the First parameter, so it returns only the first 10 results.

Example 4: Get backups for a backup policy object

PS C:\>Get-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyName "TSQATest_Default" | Get-AzureStorSimpleDeviceBackup -DeviceName "Contoso63-AppVm" -First 10 -From "9/7/2014"
BackupJobCreationType : BySchedule
CreatedOn             : 10/1/2014 11:00:12 AM
SizeInBytes           : 10737418240
Snapshots             : {ContosoTSQA}
SSMHostName           : 
Type                  : CloudSnapshot
InstanceId            : e1aec9f1-a321-443f-a058-ba78c749c2c2
Name                  : ContosoTSQA_Default
....... 

BackupJobCreationType : BySchedule
CreatedOn             : 9/29/2014 11:00:12 AM
SizeInBytes           : 10737418240
Snapshots             : {ContosoTSQA}
SSMHostName           : 
Type                  : CloudSnapshot
InstanceId            : f8041928-37b9-4048-a99c-2d3078943874
Name                  : ContosoTSQA_Default
VERBOSE: # of backups returned : 10
VERBOSE: More backups are available for your query. To access the next page of your result use \"-First 10 -Skip 10\"
in your commandlet

This command gets a BackupPolicyDetails object by using the Get-AzureStorSimpleDeviceBackupPolicy cmdlet, and then passes that object to the current cmdlet by using the pipeline operator. That cmdlet gets backups for the device named Contoso63-AppVm created by using the backup policy from the first part of the command. The command gets backups created on or before the specified date, just as in the previous example. This command returns only the first 10 results.

Example 5: Get a backup for a volume ID

PS C:\>Get-AzureStorSimpleDeviceBackup -DeviceName "Contoso63-AppVm" -VolumeId "SS-VOL-246b9df1-11bb-4071-8043-f955cc406446" -First 1
BackupJobCreationType : BySchedule
CreatedOn             : 10/9/2014 11:00:10 AM
SizeInBytes           : 10737418240
Snapshots             : {ContosoTSQA}
SSMHostName           : 
Type                  : CloudSnapshot
InstanceId            : 4fef4178-0145-404b-8257-7d958a380b8b
Name                  : ContosoTSQA_Default

VERBOSE: # of backups returned : 1
VERBOSE: No more backup sets are present for your query!

This command gets a backup on the device that is created on the volume that has the specified instance ID. This command specifies the First parameter, so it returns only the first one result.

Example 6: Get a backup for a volume name

PS C:\>Get-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "TSQATest03" | Get-AzureStorSimpleDeviceBackup -DeviceName "Contoso63-AppVm" -First 1
BackupJobCreationType : BySchedule
CreatedOn             : 10/9/2014 11:00:10 AM
SizeInBytes           : 10737418240
Snapshots             : {ContosoTSQA}
SSMHostName           : 
Type                  : CloudSnapshot
InstanceId            : 4fef4178-0145-404b-8257-7d958a380b8b
Name                  : ContosoTSQA_Default

VERBOSE: # of backups returned : 1
VERBOSE: No more backup sets are present for your query!

This command gets a VirtualDisk object by using the Get-AzureStorSimpleDeviceVolume cmdlet, and then passes that object to the current cmdlet by using the pipeline operator. That cmdlet gets backups for the device named Contoso63-AppVm created on the volume from the first part of the command. This command returns only the first result.

Parameters

-BackupPolicy

Specifies a BackupPolicyDetails object. This cmdlet uses the InstanceId of this object to determine which backups to get. To obtain a BackupPolicyDetails object, use the Get-AzureStorSimpleDeviceBackupPolicy cmdlet.

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

-BackupPolicyId

Specifies an instance ID of a backup policy. This cmdlet gets device backups for policy that this parameter specifies.

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

-DeviceName

Specifies the name of the StorSimple device for which to get backups.

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

-First

Gets only the specified number of objects. Enter the number of objects to get.

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

-From

Specifies the start date and time for the backups that this cmdlet gets.

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

-Profile

Specifies an Azure profile.

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

-Skip

Ignores the specified number of objects and then gets the remaining objects. Enter the number of objects to skip.

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

-To

Specifies the end date and time for the backups that this cmdlet gets.

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

-Volume

Specifies a VirtualDisk object. This cmdlet uses the InstanceId of this object to determine the volume in which backups exist. To obtain a VirtualDisk object, use the Get-AzureStorSimpleDeviceVolume parameter.

Type:VirtualDisk
Aliases:VirtualDiskInfo
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VolumeId

Specifies the instance ID of the volume in which backups exist.

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

Inputs

BackupPolicyDetails, VirtualDisk

This cmdlet accepts BackupPolicyDetails and VirtualDisk objects.

Outputs

IList\<Backup\>

This cmdlet returns a list of Backup objects.