Share via

Get-SCSMView

Module:
System.Center.Service.Manager Module

Retrieves views that are defined in Service Manager.

Syntax

FromDisplayName (Default) 

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

FromId 

Get-SCSMView
    [-Id] <Guid[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromName 

Get-SCSMView
    [-Name] <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Description

The Get-SCSMView cmdlet retrieves views that are defined in Service Manager.

Examples

Example 1: Display the first three defined views

PS C:\>Get-SCSMView | Select-Object -First 3
Name                                                                          Description
----                                                                          -----------
System.WorkItem.Incident.Queue.Tier2.Unassigned.View                          Lists tier 2 open unassigned incidents
AllSoftwareUpdatesView                                                        Lists all software updates
ChangeManagement.Views.ChangeRequestsCancelled                                Lists all canceled change requests

This command retrieves all of the views. The command uses the Select-Object cmdlet to return only the first three views that are defined in Service Manager.

Example 2: Get the View object

PS C:\>Get-SCSMView -Name "System.WorkItem.Incident.Queue.Tier2.Unassigned.View"
Name                                                                          Description
----                                                                          -----------
System.WorkItem.Incident.Queue.Tier2.Unassigned.View                          Lists tier 2 open unassigned incidents

This command retrieves the View object.

Example 3: Get the management pack for the View

PS C:\>$View = Get-SCSMView -Name "System.WorkItem.Incident.Queue.Tier2.Unassigned.View"
PS C:\> $View.GetManagementPack()
Sealed   Name                                 DisplayName

------   ----                                 -----------

False    ServiceManager.IncidentManagement.Co Service Manager Incident Management

         nfiguration                          Configuration Library

The first command retrieves the View object, and then stores it in the $View variable.

The second command retrieves the management pack in which the View object is defined.

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 View object to be retrieved.

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 (GUID) of the View object to be retrieved.

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

-Name

Specifies the name of the View object to be retrieved.

Parameter properties

Type:

System.String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

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

-SCSession

Specifies an 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

Microsoft.EnterpriseManagement.Configuration.ManagementPackView

This cmdlet returns view objects.