Get-SCSMQueue

Retrieves queues that are defined in Service Manager.

Syntax

Get-SCSMQueue [[-DisplayName] <String[]>] [-ComputerName <String[]>] [-Credential <PSCredential>]
 [-SCSession <Connection[]>] [<CommonParameters>]
Get-SCSMQueue [-Id] <Guid[]> [-ComputerName <String[]>] [-Credential <PSCredential>]
 [-SCSession <Connection[]>] [<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:String[]
Required:False
Position:Named
Default value:None
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:PSCredential
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisplayName

Specifies the display name of the queue to retrieve.

Type:String[]
Required:False
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Id

Specifies the ID of the queue to retrieve.

Type:Guid[]
Required:True
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-SCSession

Specifies the object that represents the session to a Service Manager management server.

Type:Connection[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

System.String

You can pipe a name to the *DisplayName* parameter.

Inputs

System.Guid

You can pipe a GUID to the *Id* parameter.

Outputs

WorkItemGroup

This cmdlet returns a unique **WorkItemGroup** queue object.