Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

Get-SCOMClassInstance

Updated: January 26, 2014

Applies To: System Center 2012 R2 Operations Manager

Get-SCOMClassInstance

Gets class instances.

Syntax

Parameter Set: Empty
Get-SCOMClassInstance [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]

Parameter Set: FromEMODisplayNameParameterSetName
Get-SCOMClassInstance [-DisplayName] <String[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]

Parameter Set: FromEMOIdParameterSetName
Get-SCOMClassInstance -Id <Guid[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]

Parameter Set: FromEMONameParameterSetName
Get-SCOMClassInstance -Name <String[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]

Parameter Set: FromGroup
Get-SCOMClassInstance [-Group] <EnterpriseManagementObject[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]

Parameter Set: FromManagementPackClass
Get-SCOMClassInstance [-Class] <ManagementPackClass[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]




Detailed Description

The Get-SCOMClassInstance cmdlet gets one or more class instances. A class represents a kind of object, and every object in System Center 2012 – Operations Manager is considered an instance of a particular class. All instances of a class share a common set of properties.

Parameters

-Class<ManagementPackClass[]>

Specifies an array of ManagementPackClass objects. To obtain a ManagementPackClass object, use the Get-SCOMClass cmdlet.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-ComputerName<String[]>

Specifies an array of names of computers. You can use NetBIOS names, IP addresses, or fully qualified domain names (FQDNs). To specify the local computer, type the computer name, localhost, or a dot (.).

The System Center Data Access service must be running on the computer. If you do not specify a computer, the cmdlet uses the computer for the current management group connection.


Aliases

none

Required?

false

Position?

named

Default Value

localhost

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Credential<PSCredential>

Specifies a PSCredential object for the management group connection. To obtain a PSCredential object, use the Get-Credential cmdlet. For more information, type Get-Help Get-Credential.

If you specify a computer in the ComputerName parameter, use an account that has access to that computer. The default is the current user.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-DisplayName<String[]>

Specifies an array of display names of objects. Values for this parameter depend on which localized management packs you import and the locale of the user that runs Windows PowerShell.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

true

-Group<EnterpriseManagementObject[]>

Specifies an array of EnterpriseManagementObject objects. To obtain a EnterpriseManagementObject object, use the Get-SCOMGroup cmdlet. For more information, type Get-Help Get-SCOMGroup.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Id<Guid[]>

Specifies an array of GUIDs of classe instances. To get the GUID of a class, type Get-SCOMClassInstance | Format-Table DisplayName, Id.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Name<String[]>

Specifies an array of names of objects.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

true

-SCSession<Connection[]>

Specifies an array of Connection objects. To obtain a Connection object, use the Get-SCOMManagementGroupConnection cmdlet.

A connection object represents a connection to a management server. The default is the current management group connection.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Gets class instances by using a display name

This command gets the class instance that has the display name Server01.Contoso.Com and the class instances in the contoso.com domain.


PS C:\> Get-SCOMClassInstance -Displayname "Server01.Contoso.Com", "*.contoso.com"

Example 2: Gets class instances by using a name

This command gets class instances of classes. The command uses the Get-SCOMClass to get all classes that have "Windows" in their name, and passes the result to the Get-SCOMClassInstance cmdlet by using the pipeline operator. The command gets the class instances for the classes that have Windows in their name.


PS C:\> Get-SCOMClass -Name "*Windows*" | Get-SCOMClassInstance

Example 3: Gets class instances by using an Id

This command gets the class instance that has an Id of 7413b06b-a95b-4ae3-98f2-dac9ff76dabd.


PS C:\> Get-SCOMClassInstance -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd

Related topics


Get-SCOMClass

Get-SCOMGroup

 
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.