Import-SCOMManagementPack
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]
Import-SCOMManagementPack
Imports management packs.
Syntax
Parameter Set: Default
Import-SCOMManagementPack [-ComputerName <String> ] [-Credential <PSCredential> ] [-Fullname <String> ] [-ManagementPack <ManagementPack> ] [-PassThru] [-SCSession <Connection> ] [ <CommonParameters>]
Detailed Description
The Import-SCOMManagementPack cmdlet imports management packs.
Service Manager or Operations Manager attempts to validate the XML code of the management packs before the import. If the management pack contains XML code that is not valid, the management pack is not imported, and an error is returned.
Parameters
-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 |
User account of the current context. |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Fullname<String>
Specifies the full paths and file names of the management packs to import. The list must contain files that are management packs (*.xml, *.mp) or management pack bundles (*.mpb). If you specify a management pack bundle, all management packs from that bundle are imported.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ManagementPack<ManagementPack>
Specifies one or more management packs to import. You can enter a ManagementPack object that is returned by the Get-SCOMManagementPack or the Get- SCOMManagementPack cmdlet.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-PassThru
Passes the newly imported management pack to the pipeline. 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 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.EnterpriseManagement.Configuration.ManagementPack
An object that represents the management pack, available only when you use the -PassThru parameter.
Notes
- If you specify multiple management packs, then the order in which those management packs are imported will satisfy management pack interdependencies. As a result, management packs might be imported in an order that differs from the order that is provided at the command prompt.
Examples
-------------------------- EXAMPLE 1 --------------------------
This command imports the management pack file c:\temp\mymanagementpack.xml.
PS C:\>PS C:\>Import-SCOMManagementPack c:\temp\mymanagementpack.xml
-------------------------- EXAMPLE 2 --------------------------
This command imports only the Woodgrove.ManagementPack management pack that is included in the c:\temp\mymanagementpackbundle.mpb management pack bundle file.
PS C:\>PS C:\>Import-SCOMManagementPack c:\temp\mymanagementpackbundle.mpb -name Woodgrove.ManagementPack
-------------------------- EXAMPLE 3 --------------------------
This command imports only the Woodgrove.ManagementPack management pack that is included in the c:\temp\mymanagementpackbundle.mpb management pack bundle file, and displays information about the imported management pack.
PS C:\>PS C:\>Import-SCOMManagementPack c:\temp\mymanagementpackbundle.mpb -name Woodgrove.ManagementPack -passthru
IsSealed Name
-------- -----
False Woodgrove.ManagementPack