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.