Get-SCSMManagementPack
Get-SCSMManagementPack
Gets management packs.
Syntax
Parameter Set: Empty
Get-SCSMManagementPack [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]
Parameter Set: FromManagementPackBundle
Get-SCSMManagementPack [-BundleFile] <String[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]
Parameter Set: FromManagementPackDisplayName
Get-SCSMManagementPack [-DisplayName] <String[]> [[-Recurse]] [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]
Parameter Set: FromManagementPackFile
Get-SCSMManagementPack [-ManagementPackFile] <String[]> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]
Parameter Set: FromManagementPackGuid
Get-SCSMManagementPack [-Id] <Guid[]> [[-Recurse]] [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]
Parameter Set: FromManagementPackName
Get-SCSMManagementPack [-Name] <String[]> [[-Recurse]] [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]
Detailed Description
The Get-SCSMManagementPack cmdlet retrieves management packs that have been imported into a management group, exist in management pack files (.mp, .xml), or 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? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue, ByPropertyName) |
Accept Wildcard Characters? |
false |
-ComputerName<String[]>
Specifies a computer with which to establish a connection. 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 (.).
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
localhost |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
The user account of the current context |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-DisplayName<String[]>
Specifies the display name of the management packs to retrieve. This parameter is interpreted as a regular expression.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue, ByPropertyName) |
Accept Wildcard Characters? |
false |
-Id<Guid[]>
Specifies the ID of the management packs to retrieve.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-ManagementPackFile<String[]>
Specifies the file name (.xml or .mp) of the management packs to retrieve.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue, ByPropertyName) |
Accept Wildcard Characters? |
false |
-Name<String[]>
Specifies the names of the management packs to retrieve. This parameter is interpreted as a regular expression.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
.* |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Recurse
Indicates that the specified management pack, and all management packs that depend on it, are retrieved.
Aliases |
none |
Required? |
false |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
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 the GUID of a management pack to the Id parameter of the Get-SCSMManagementPack cmdlet.
System.String
You can pipe the name of a management pack to the Name parameter of the Get-SCSMManagementPack 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: Get all imported management packs
This command retrieves all imported management packs.
PS C:\>Get-SCSMManagementPack
Example 2: Get an individual management pack
This command retrieves the System.Library management pack.
PS C:\>Get-SCSMManagementPack -Name "System.Library"