Get-SCSMQueue
Retrieves queues that are defined in Service Manager.
Syntax
Get-SCSMQueue
[[-DisplayName] <String[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCSMQueue
[-Id] <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
The Get-SCSMQueue cmdlet retrieves queues that are defined in Service Manager.
Examples
Example 1: Get all available queues
PS C:\>Get-SCSMQueue
WorkItemType DisplayName Description ManagementPackName TimeAdded LastModified
------------ ----------- ----------- ------------------ --------- ------------
Incident queue1 just a description ServiceManager.IncidentManagement.Configuration 12/1/2010 12:48:26 AM 12/1/2010 12:48:26 AM
This command retrieves all the queues that are available in Service Manager.
Example 2: Get queues by using a display name
PS C:\>Get-SCSMQueue -DisplayName "queue*"
WorkItemType DisplayName Description ManagementPackName TimeAdded LastModified
------------ ----------- ----------- ------------------ --------- ------------
Incident queue1 just a description ServiceManager.IncidentManagement.Configuration 12/1/2010 12:48:26 AM 12/1/2010 12:48:26 AM
This command retrieves the queues in which DisplayName is like queue.
Parameters
-ComputerName
Specifies the name of the computer on which the System Center Data Access service runs. The user account that is specified in the Credential parameter must have access rights to the specified computer.
Type: | System.String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Specifies the credentials that this cmdlet uses to connect to the server on which the System Center Data Access service runs. The specified user account must have access rights to that server.
Type: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Specifies the display name of the queue to retrieve.
Type: | System.String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Id
Specifies the ID of the queue to retrieve.
Type: | System.Guid[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SCSession
Specifies the object that represents the session to a Service Manager management server.
Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
System.String
You can pipe a name to the DisplayName parameter.
System.Guid
You can pipe a GUID to the Id parameter.
Outputs
WorkItemGroup
This cmdlet returns a unique WorkItemGroup queue object.