Share via


Import-SCOMManagementPack

Import-SCOMManagementPack

Imports management packs.

Syntax

Parameter Set: FromManagementPackFile
Import-SCOMManagementPack [-Fullname] <String[]> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: __AllParameterSets
Import-SCOMManagementPack [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-PassThru] [-SCSession <Connection[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromManagementPack
Import-SCOMManagementPack [-ManagementPack] <ManagementPack[]> [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Import-SCOMManagementPack cmdlet imports System Center 2012 – Operations Manager management packs. You can export a management pack to an XML-formatted file by using the Export-SCOMManagementPack cmdlet.

Before the cmdlet imports a management pack, System Center 2012 – Operations Manager attempts to validate the management pack. If the management pack contains invalid XML, the cmdlet does not import the management pack and raises an error.

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

-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

User account of the current context.

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Fullname<String[]>

Specifies an array of full paths and file names of management packs to import. Include management packs (*.xml, *.mp) or management pack bundles (*.mpb). If you specify a management pack bundle, the cmdlet imports all management packs from that bundle.

If you specify multiple management packs, the cmdlet imports them in the order that satisfies management pack dependencies. As a result, the cmdlet may import management packs in a different order from the one you specify.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-ManagementPack<ManagementPack[]>

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

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Aliases

none

Required?

false

Position?

named

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?

false

Position?

named

Default Value

false

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.

  • Microsoft.EnterpriseManagement.Configuration.ManagementPack

    You can pipe a management pack object to the ManagementPack parameter of this cmdlet.

Outputs

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

  • Microsoft.EnterpriseManagement.Configuration.ManagementPack

    When you specify the PassThru parameter, this cmdlet returns an object that represents the management pack.

Examples

Example 1: Import a management pack from a file

This command imports the management pack file C:\MPArchive\MPWesternOffice.xml.

PS C:\> Import-SCOMManagementPack -Fullname "C:\MPArchive\MPWesternOffice.xml"

Example 2: Import a management pack from a management pack bundle

This command imports only the Woodgrove.ManagementPack management pack that is included in the C:\MPArchive\MPWesternOfficeBundle.mpb management pack bundle file.

PS C:\> Import-SCOMManagementPack -Fullname "C:\MPArchive\MPWesternOfficeBundle.mpb" -Name Woodgrove.ManagementPack

Export-SCOMManagementPack

Get-SCOMManagementPack

Remove-SCOMManagementPack

Get-SCOMManagementGroupConnection

Get-Credential