Get-SCOMManagementPack

Get-SCOMManagementPack

Gets management packs.

Syntax

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

Parameter Set: FromManagementPackBundle
Get-SCOMManagementPack [-BundleFile] <String[]> [ <CommonParameters>]

Parameter Set: FromManagementPackDisplayName
Get-SCOMManagementPack [-DisplayName] <String[]> [[-Recurse]] [ <CommonParameters>]

Parameter Set: FromManagementPackFile
Get-SCOMManagementPack [-ManagementPackFile] <String[]> [ <CommonParameters>]

Parameter Set: FromManagementPackGuid
Get-SCOMManagementPack [-Id] <Guid[]> [[-Recurse]] [ <CommonParameters>]

Parameter Set: FromManagementPackName
Get-SCOMManagementPack [-Name] <String[]> [[-Recurse]] [ <CommonParameters>]

Detailed Description

The Get-SCOMManagementPack cmdlet gets System Center 2012 – Operations Manager management packs. You can get management packs from a management group, from a management pack file with an .mp or .xml file name extension, or from a management pack bundle with an .mpb file name extension.

By default, this cmdlet uses the active persistent connection to a management group. Use the SCSession parameter to specify a different persistent connection. You can create a temporary connection to a management group by using the ComputerName and Credential parameters. For more information, type Get-Help about_OpsMgr_Connections.

Parameters

-BundleFile<String[]>

Specifies an array of names of management pack bundle files. Bundle files use an .mpb file name extension.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ComputerName<String[]>

Specifies an array of names of computers. The cmdlet establishes temporary connections with management groups for these 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?

false

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

The user account of the current context

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DisplayName<String[]>

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

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

true

-Id<Guid[]>

Specifies an array of GUIDs.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-ManagementPackFile<String[]>

Specifies an array of management pack files. Management pack files use .xml or .mp file name extensions.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String[]>

Specifies an array of names of management pack files. You can use wildcards.

Aliases

none

Required?

true

Position?

1

Default Value

.*

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

true

-Recurse

Indicates that the cmdlet recursively gets all management packs that depend on specified management packs.

Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SCSession<Connection[]>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<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.

  • System.Guid

    You can pipe GUIDs of management packs to the Id parameter of this cmdlet.

  • System.String

    You can pipe names of management packs to the Name parameter of this cmdlet.

Outputs

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

  • Microsoft.EnterpiseManagement.Configuration.ManagementPack

    A management pack object contains a management pack and its properties.

Examples

Example 1: Get management packs from a management group

This command gets all the management packs for the current management group.

PS C:\> Get-SCOMManagementPack

Example 2: Get a management pack from a management group by using its name

This command gets a management pack named System.Library from the current management group.

PS C:\> Get-SCOMManagementPack -Name "System.Library"

Import-SCOMManagementPack

New-SCOMManagementPackBundle

Export-SCOMManagementPack

New-SCOMManagementPack

Protect-SCOMManagementPack

Remove-SCOMManagementPack

Test-SCOMManagementPack

Get-SCOMManagementGroupConnection

Get-Credential