Get-SCSMClass

Get-SCSMClass

Retrieves a class.

Syntax

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

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

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

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

Parameter Set: FromEMO
Get-SCSMClass [-Instance] <EnterpriseManagementObject[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]

Parameter Set: FromManagementPack
Get-SCSMClass [-ManagementPack] <ManagementPack[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]

Detailed Description

The Get-SCSMClass cmdlet retrieves a class.

Parameters

-ComputerName<String[]>

Specifies a computer to establish a connection with. The computer must be running the System Center Data Access service. The default value is the computer for the current management group connection.

Valid formats include a NetBIOS name, an IP address, or a fully qualified domain name (FQDN). To specify the local computer, type the computer name, "localhost", or a dot (.).

-Credential<PSCredential>

Specifies a user account under which the management group connection will run. The account must have access to the server that is specified in the ComputerName parameter, if the server is specified. The default value is the current user.

You can enter a PSCredential object that is returned by the Get-Credential cmdlet.

-DisplayName<String[]>

Specifies the display name of the class to retrieve.

-Id<Guid[]>

Specifies the Id of the class to retrieve. This may be a Guid or a string that will be converted to a Guid.

-Instance<EnterpriseManagementObject[]>

Specifies an instance of a class to retrieve.

-ManagementPack<ManagementPack[]>

Specifies one or more management packs containing the classes to retrieve.

You can enter a ManagementPack object that is returned by the Get-SCManagementPack cmdlet.

-Name<String[]>

Specifies the name of a class to retrieve.

-SCSession<Connection[]>

Specifies a connection to a management server. The default value is the current management group connection.

You can enter a management group connection object that is returned by the Get-SCManagementGroupConnection cmdlet.

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

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

• Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject

  You can pipe an instance of a management pack to the Instance parameter of the Get-SCSMClass cmdlet. The Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject object is one the properties of the output object of the Get-SCSMClassinstance cmdlet.

• System.Guid

  You can pipe a Guid to the Id parameter of the Get-SCSMClass cmdlets.

• Microsoft.EnterpriseManagement.Configuration.ManagementPackManagementPack

  You can pipe a management pack to the ManagementPack parameter of the Get-SCSMClass cmdlet. This management pack object should contain the class to retrieve.

• System.String

  You can pipe a name to the Name parameter of the Get-SCSMClass cmdlet.

Outputs

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

• Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

  This cmdlet generates a management pack object.

Examples

-------------------------- EXAMPLE 1 --------------------------

The command in this example retrieves all classes that end with “user”.

PS C:\>Get-SCSMClass -name *user

-------------------------- EXAMPLE 2 --------------------------

The command in this example retrieves the class in which DisplayName equals "User".

C:\PS>Get-SCSMClass -DisplayName User

-------------------------- EXAMPLE 3 --------------------------

The command in this example determines the class of an object, for which all you have is the object itself.

C:\PS>Get-SCSMClass -name System.User | Get-scsmclassinstance |select -first 1 | %{$_.__enterprisemanagementobject}|Get-SCSMClass