< Back
Get-StorageJob
Post
NAME Get-StorageJob
SYNOPSIS
Returns information about long-running Storage module jobs, such as a repair task.
SYNTAX
Get-StorageJob [-CimSession <CimSession[]>] [-JobState <JobState[]>] [-ThrottleLimit <Int32>] [-UniqueId <String[]>] [<CommonParameters>]
Get-StorageJob [-CimSession <CimSession[]>] [-JobState <JobState[]>] [-Name <String[]>] [-StoragePool <CimInstance>] [-ThrottleLimit <Int32>]
[-VirtualDisk <CimInstance>] [<CommonParameters>]
Get-StorageJob [-CimSession <CimSession[]>] [-JobState <JobState[]>] [-StorageSubsystem <CimInstance>] [-ThrottleLimit <Int32>] [<CommonParameters>]
Get-StorageJob [-CimSession <CimSession[]>] [-JobState <JobState[]>] [-Name <String[]>] [-ThrottleLimit <Int32>] [<CommonParameters>]
Get-StorageJob [-Disk <CimInstance>] [<CommonParameters>]
Get-StorageJob [-Volume <CimInstance>] [<CommonParameters>]
DESCRIPTION
The Get-StorageJob cmdlet returns information about long-running Storage module jobs, such as a repair operation on a storage space.
PARAMETERS
-CimSession [<CimSession[]>]
Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or
Get-CimSession cmdlet. The default is the current session on the local computer.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Disk [<CimInstance>]
Specifies a disk for which to get storage jobs. To obtain a Disk object, use the Get-Disk cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-JobState [<JobState[]>]
Gets storage jobs in the specified state. Acceptable values are Completed, Exception, Killed, New, QueryPending, Running, Service, ShuttingDown,
Starting, Suspended, and Terminated.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Name [<String[]>]
Specifies the name the storage job to get.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-StoragePool [<CimInstance>]
Specifies the storage pool object in which to retrieve storage jobs. Enter a StoragePool CIM object. The StoragePool CIM object is exposed by the
Get-StoragePool cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-StorageSubsystem [<CimInstance>]
Specifies the storage subsystem object in which to retrieve storage jobs. Enter a StorageSubsystem CIM object. The StorageSubsystem CIM object is
exposed by the Get-StorageSubSystem cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-ThrottleLimit [<Int32>]
Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is
entered, then Windows PowerShell???? calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the
computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-UniqueId [<String[]>]
Specifies the ID of the storage job to retrieve.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-VirtualDisk [<CimInstance>]
Specifies the virtual disk object for which to get storage jobs. Enter a VirtualDisk CIM object. The Virtual Disk CIM object is exposed by the
Get-VirtualDisk cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Volume [<CimInstance>]
Specifies the volume object for which to get storage jobs. To obtain a Volume object, use the Get-Volume cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StoragePool
http://msdn.microsoft.com/library/windo ... 30551.aspx
You can pipe an MSFT_StoragePool object to the StoragePool parameter to specify the storage pool in which to get storage jobs.
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StorageSubsystem
http://msdn.microsoft.com/library/windo ... 30569.aspx
You can pipe an MSFT_StorageSubsystem object to the StorageSubsystem parameter to specify the storage subsystem for which to get storage jobs.
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_VirtualDisk
http://msdn.microsoft.com/library/windo ... 30584.aspx
You can pipe an MSFT_VirtualDisk object to the VirtualDisk parameter to specify the virtual disk for which to get storage jobs.
OUTPUTS
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StorageJob
http://msdn.microsoft.com/library/windo ... 30545.aspx
The Get-StorageJob cmdlet returns objects that represent storage jobs.
Example 1: Get all current storage jobs
PS C:\\>Get-StorageJob
Name ElapsedTime JobState PercentComplete IsBackgroundTask
---- ----------- -------- --------------- ----------------
Regeneration 00:00:00 Running 50 True
This example displays a list of all current storage jobs.
Example 2: Get all storage jobs on the Windows Storage subsystem
PS C:\\>Get-StorageJob -StorageSubsystem (Get-StorageSubSystem -FriendlyName "Storage Spaces*")
This example gets all storage jobs on the Storage Spaces subsystem, using the Get-StorageSubSystem cmdlet to get the StorageSubsystem object.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=816408
Receive-Job
Get-DiskStorageNodeView
Get-Volume
SYNOPSIS
Returns information about long-running Storage module jobs, such as a repair task.
SYNTAX
Get-StorageJob [-CimSession <CimSession[]>] [-JobState <JobState[]>] [-ThrottleLimit <Int32>] [-UniqueId <String[]>] [<CommonParameters>]
Get-StorageJob [-CimSession <CimSession[]>] [-JobState <JobState[]>] [-Name <String[]>] [-StoragePool <CimInstance>] [-ThrottleLimit <Int32>]
[-VirtualDisk <CimInstance>] [<CommonParameters>]
Get-StorageJob [-CimSession <CimSession[]>] [-JobState <JobState[]>] [-StorageSubsystem <CimInstance>] [-ThrottleLimit <Int32>] [<CommonParameters>]
Get-StorageJob [-CimSession <CimSession[]>] [-JobState <JobState[]>] [-Name <String[]>] [-ThrottleLimit <Int32>] [<CommonParameters>]
Get-StorageJob [-Disk <CimInstance>] [<CommonParameters>]
Get-StorageJob [-Volume <CimInstance>] [<CommonParameters>]
DESCRIPTION
The Get-StorageJob cmdlet returns information about long-running Storage module jobs, such as a repair operation on a storage space.
PARAMETERS
-CimSession [<CimSession[]>]
Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or
Get-CimSession cmdlet. The default is the current session on the local computer.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Disk [<CimInstance>]
Specifies a disk for which to get storage jobs. To obtain a Disk object, use the Get-Disk cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
-JobState [<JobState[]>]
Gets storage jobs in the specified state. Acceptable values are Completed, Exception, Killed, New, QueryPending, Running, Service, ShuttingDown,
Starting, Suspended, and Terminated.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Name [<String[]>]
Specifies the name the storage job to get.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-StoragePool [<CimInstance>]
Specifies the storage pool object in which to retrieve storage jobs. Enter a StoragePool CIM object. The StoragePool CIM object is exposed by the
Get-StoragePool cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-StorageSubsystem [<CimInstance>]
Specifies the storage subsystem object in which to retrieve storage jobs. Enter a StorageSubsystem CIM object. The StorageSubsystem CIM object is
exposed by the Get-StorageSubSystem cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-ThrottleLimit [<Int32>]
Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is
entered, then Windows PowerShell???? calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the
computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-UniqueId [<String[]>]
Specifies the ID of the storage job to retrieve.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-VirtualDisk [<CimInstance>]
Specifies the virtual disk object for which to get storage jobs. Enter a VirtualDisk CIM object. The Virtual Disk CIM object is exposed by the
Get-VirtualDisk cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Volume [<CimInstance>]
Specifies the volume object for which to get storage jobs. To obtain a Volume object, use the Get-Volume cmdlet.
Required? false
Position? named
Default value none
Accept pipeline input? true(ByValue)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StoragePool
http://msdn.microsoft.com/library/windo ... 30551.aspx
You can pipe an MSFT_StoragePool object to the StoragePool parameter to specify the storage pool in which to get storage jobs.
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StorageSubsystem
http://msdn.microsoft.com/library/windo ... 30569.aspx
You can pipe an MSFT_StorageSubsystem object to the StorageSubsystem parameter to specify the storage subsystem for which to get storage jobs.
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_VirtualDisk
http://msdn.microsoft.com/library/windo ... 30584.aspx
You can pipe an MSFT_VirtualDisk object to the VirtualDisk parameter to specify the virtual disk for which to get storage jobs.
OUTPUTS
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StorageJob
http://msdn.microsoft.com/library/windo ... 30545.aspx
The Get-StorageJob cmdlet returns objects that represent storage jobs.
Example 1: Get all current storage jobs
PS C:\\>Get-StorageJob
Name ElapsedTime JobState PercentComplete IsBackgroundTask
---- ----------- -------- --------------- ----------------
Regeneration 00:00:00 Running 50 True
This example displays a list of all current storage jobs.
Example 2: Get all storage jobs on the Windows Storage subsystem
PS C:\\>Get-StorageJob -StorageSubsystem (Get-StorageSubSystem -FriendlyName "Storage Spaces*")
This example gets all storage jobs on the Storage Spaces subsystem, using the Get-StorageSubSystem cmdlet to get the StorageSubsystem object.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=816408
Receive-Job
Get-DiskStorageNodeView
Get-Volume