Get-AzureStorSimpleJob

Gets StorSimple jobs.

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-AzureStorSimpleJob
   [-DeviceName <String>]
   [-InstanceId <String>]
   [-Status <String>]
   [-Type <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Skip <Int32>]
   [-First <Int32>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

The Get-AzureStorSimpleJob cmdlet gets Azure StorSimple jobs. Specify an instance ID to get a specific job. Specify other parameters to limit the jobs that this cmdlet gets.

This cmdlet returns a maximum of 200 jobs. If more than 200 jobs exist, get the remaining jobs 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 a job by using an ID

PS C:\>Get-AzureStorSimpleJob -InstanceId "574f47e0-44e9-495c-b8a5-0203c57ebf6d"
BackupPolicy             : 
BackupTimeStamp          : 1/1/0001 12:00:00 AM
BackupType               : CloudSnapshot
DataStats                : Microsoft.WindowsAzure.Management.StorSimple.Models.DataStatistics
Device                   : Microsoft.WindowsAzure.Management.StorSimple.Models.CisBaseObject
Entity                   : Microsoft.WindowsAzure.Management.StorSimple.Models.CisBaseObject
ErrorDetails             : {}
HideProgressDetails      : False
InstanceId               : 574f47e0-44e9-495c-b8a5-0203c57ebf6d
IsInstantRestoreComplete : False
IsJobCancellable         : True
JobDetails               : Microsoft.WindowsAzure.Management.StorSimple.Models.JobStatusInfo
Name                     : 26447caf-59bb-41c9-a028-3224d296c7dc
Progress                 : 100
SourceDevice             : Microsoft.WindowsAzure.Management.StorSimple.Models.CisBaseObject
SourceEntity             : Microsoft.WindowsAzure.Management.StorSimple.Models.CisBaseObject
SourceVolume             : Microsoft.WindowsAzure.Management.StorSimple.Models.CisBaseObject
Status                   : Completed
TimeStats                : Microsoft.WindowsAzure.Management.StorSimple.Models.TimeStatistics
Type                     : Backup
Volume                   : Microsoft.WindowsAzure.Management.StorSimple.Models.CisBaseObject

This command gets information for the job that has the specified ID.

Example 2: Get jobs by using a device name

PS C:\>Get-AzureStorSimpleJob -DeviceName "8600-Bravo 001" -First 2
InstanceId                           Type                         Status                                          DeviceName                                      StartTime                                       Progress                                       
----------                           ----                         ------                                          ----------                                      ---------                                       --------                                       
1997c33f-bfcc-4d08-9aba-28068340a1f9 Backup                       Running                                         8600-Bravo 001                                  4/15/2015 1:30:02 PM                            92                                             
85074062-ef6a-408a-b6c9-2a0904bb99ca Backup                       Completed                                       8600-Bravo 001                                  4/15/2015 1:30:02 PM                            100

This command gets information for the jobs for the device named 8600-Bravo 001. The command gets the first two jobs for the device.

Example 3: Get completed jobs

PS C:\>Get-AzureStorSimpleJob -Status "Completed" -Skip 10 -First 2

This command gets completed jobs. The command gets only the first two jobs after it skips the first ten jobs.

Example 4: Get manual backup jobs

PS C:\>Get-AzureStorSimpleJob -Type "ManualBackup"

This command gets jobs of the manual backup type.

Example 5: Get jobs between specified times

PS C:\>$StartTime = Get-Date -Year 2015 -Month 3 -Day 10
PS C:\> $EndTime = Get-Date -Year 2015 -Month 3 -Day 11 -Hour 12 -Minute 15
PS C:\>Get-AzureStorSimpleJob -DeviceName "Device07" -From $StartTime -To $EndTime

The first two commands create DateTime objects by using the Get-Date cmdlet. The commands store the new times in the $StartTime and $EndTime variables. For more information, type Get-Help Get-Date.

The final command gets jobs for the device named Device07 between the times stored in $StartTime and $EndTime.

Parameters

-DeviceName

Specifies the name of a StorSimple device.

Type:String
Position:Named
Default value:None
Required:False
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 jobs that this cmdlet gets.

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

-InstanceId

Specifies the ID of the job to get.

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

-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

-Status

Specifies the status. The acceptable values for this parameter are:

  • Running
  • Completed
  • Cancelled
  • Failed
  • Canceling
  • CompletedWithErrors
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-To

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

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

-Type

Specifies the job type. The acceptable values for this parameter are:

  • Backup
  • ManualBackup
  • Restore
  • CloneWorkflow
  • DeviceRestore
  • Update
  • SupportPackage
  • VirtualApplianceProvisioning
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

You cannot pipe input to this cmdlet.

Outputs

IList\<DeviceJobDetails\>, DeviceJobDetails

This cmdlet returns a list of job details objects, or, if you specify the InstanceID parameter, it returns a single job detail object.