Share via


Get-SCSMQueue

Retrieves queues that are defined in Service Manager.

Syntax

FromDisplayName (Default)

Get-SCSMQueue
    [[-DisplayName] <String[]>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromId

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.

Parameter properties

Type:

System.String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:System.Management.Automation.PSCredential
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisplayName

Specifies the display name of the queue to retrieve.

Parameter properties

Type:

System.String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromDisplayName
Position:0
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Id

Specifies the ID of the queue to retrieve.

Parameter properties

Type:

System.Guid[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromId
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-SCSession

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

Parameter properties

Type:

Microsoft.SystemCenter.Core.Connection.Connection[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

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.