Import-CMApplication
Imports an application into Configuration Manager.
Syntax
Default (Default)
Import-CMApplication
-FilePath <String>
[-ImportActionType <ImportActionType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Import-CMApplication cmdlet imports a package created by the Export-CMApplication cmdlet. A package contains one or more applications and related objects, such as catalogs. If the package contains content, the application package imports the content, or includes a reference to the content.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Examples
Example 1: Import an application
PS XYZ:\>Import-CMApplication -FilePath "\\Server1\resource\test.zip" -ImportActionType DirectImport
This command imports the application stored in test.zip, including the application objects.
Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DisableWildcardHandling
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-FilePath
Specifies a file path for the application.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | FileName, ImportFilePath, Path |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ForceWildcardHandling
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ImportActionType
Specifies an import action type for the application. If this application already exists in the Software Library, Configuration Manager adds a revision to the existing application unless you modify the action to create a new application. Valid values are:
- Skip. This option is not supported.
- NotSet.
No action is specified.
The default behavior is:
- If there is a conflict with the application model ID, a new revision is added to the existing application.
- If there is a conflict with the application name, a new application is created with a new name.
- DirectImport.
Imports the application objects.
The default behavior is:
- If there is a conflict with the application model ID, the error is displayed.
- If there is a conflict with the application name, a new application is created with a new name.
- Rename. This option is not supported.
- Overwrite. Maps objects despite name or scope duplication. If the revision of the application does not match the revision of the application to import, then a new revision is added to the existing application.
- ImportFail. This option is not supported.
Parameter properties
| Type: | ImportActionType |
| Default value: | None |
| Accepted values: | NotSet, Skip, DirectImport, Rename, Overwrite, ImportFail |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet doesn't run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.