Get-SCOMManagementPack

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Get-SCOMManagementPack

Retrieves management packs that have been imported into a management group, exist in management pack files (.mp, .xml), or that reside within a management pack bundle (.mpb) file.

Syntax

Parameter Set: Default
Get-SCOMManagementPack [-BundleFile <String> ] [-ComputerName <String> ] [-Credential <PSCredential> ] [-DisplayName <String> ] [-Id <Guid> ] [-ManagementPackFile <String> ] [-Name <String> ] [-Recurse] [-SCSession <Connection> ] [ <CommonParameters>]

Detailed Description

The Get-SCOMManagementPack cmdlet retrieves management packs that have been imported into a management group, exist in management pack files (.mp, .xml), or that reside within a management pack bundle (.mpb) file.

Parameters

-BundleFile<String>

Specifies the names of the management pack bundle files (.mpb) from which to retrieve management packs.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ComputerName<String>

Specifies the name of 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. To specify the local computer, type the computer name, "localhost", or a dot (.).

Aliases

none

Required?

false

Position?

named

Default Value

localhost

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Credential<PSCredential>

Specifies a user account under which the management group connection will run, that must have access to the server identifed by the ComputerName parameter (if specified). Default value is the current user. You can enter a PSCredential object that is returned by the Get-Credential cmdlet.

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 the Display name of the management packs to retrieve.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Id<Guid>

Specifies the ID of the management packs to retrieve.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ManagementPackFile<String>

Specifies the file name (.xml or .mp) of the management packs to retrieve.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String>

Specifies the names of the management packs to retrieve.

Aliases

none

Required?

false

Position?

named

Default Value

.*

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Recurse

Recursively retrieves all management packs that are dependent on the management packs that are specified to be retrieved.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SCSession<Connection>

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

You can enter a management group connection object that is returned by the Get-SCOMManagementGroupConnection or 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

Inputs

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

  • You cannot pipe input to this cmdlet.

Outputs

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

  • Microsoft.EnterpiseManagement.Configuration.ManagementPack

    The management pack object contains the management pack and its properties.

Examples

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

The command in this example retrieves all imported management packs.

PS C:\>PS C:\>Get-SCOMManagementPack
Sealed Name                                                            DisplayName
------ ----                                                            -----------
True Microsoft.SystemCenter.InstanceGroup.Library                    Instance Group Library
True Microsoft.Windows.Peripheral.Library                            Windows Peripheral Library
True ServiceManager.ActivityManagement.Library
True System.Software.Library                                         System Software Library
True Microsoft.SystemCenter.Deployment.Library
True ServiceManager.KnowledgeManagement.Library
True Microsoft.EnterpriseManagement.ServiceManager.UI.Administration ServiceManager Administration ManagementPack
False ServiceManager.LinkingFramework.Configuration
True ServiceManager.LinkingFramework.Library
True System.Snmp.Library                                             SNMP Library
True ServiceManager.Core.Library                                     Service Manager Core Library
True Microsoft.EnterpriseManagement.ServiceManager.UI.Console        Service Manager Console ManagementPack
True System.ApplicationLog.Library                                   Application Log Library
True Microsoft.EnterpriseManagement.ServiceManager.UI.Authoring      Service Manager Authoring ManagementPack
True Microsoft.SystemCenter.Library                                  System Center Core Library
False Microsoft.EnterpriseManagement.ServiceManager.Default
True Microsoft.SystemCenter.WorkItemGroup.Library                    Instance Group Library
True System.Library                                                  System Library
True Microsoft.Windows.Library                                       Windows Core Library
True Microsoft.SystemCenter.ConfigurationManager                     Microsoft SystemCenter ConfigurationManager Library
True Microsoft.EnterpriseManagement.ServiceManager.Connector.Sms
False ServiceManager.ChangeManagement.Configuration                   ServiceManager ChangeManagement Configuration
True System.Health.Library                                           Health Library
True Microsoft.SystemCenter.WorkflowFoundation.Library               System Center Workflow Foundation Library
True Microsoft.SystemCenter.Report.Library
True ServiceManager.Datawarehouse.Library
True Microsoft.EnterpriseManagement.ServiceManager.Connector.AD
True ServiceManager.ConfigurationManagement.Library
False ServiceManager.ActivityManagement.Configuration
True System.Notifications.Library                                    System Notification Library
True ServiceManager.IncidentManagement.Library                       Incident Management Library
True Microsoft.SystemCenter.Subscriptions
True ServiceManager.ChangeManagement.Library
True System.Performance.Library                                      Performance Library
False ServiceManager.IncidentManagement.Configuration                 Incident Management Configuration


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

The command in this example retrieves only the System.Library management pack.

PS C:\>PS C:\>Get-SCOMManagementPack -Name System.Library
Sealed Name           DisplayName
------ ----           -----------
True System.Library System Library

Import-SCOMManagementPack

New-SCOMManagementPackBundle

Export-SCOMManagementPack

New-SCOMManagementPack

Protect-SCOMManagementPack

Remove-SCOMManagementPack

Test-SCOMManagementPack