Import-CMSoftwareLicense

Imports a software license.

Syntax

Import-CMSoftwareLicense
      -ImportType <ImportType>
      -MlsFilePath <String>
      [-Timeout <TimeSpan>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Import-CMSoftwareLicense cmdlet imports Microsoft and non-Microsoft licensing information into the Asset Intelligence catalog in Configuration Manager.

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 a software license

PS XYZ:\>Import-CMSoftwareLicense -MlsFilePath "\\ContosoFS01\Mid\SWLicense01.xml" -ImportType MicrosftVolumeLicenseStatement

This command imports a MVLS license statement from the licensing information file named SWLicense01.xml.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImportType

Specifies an import type for the software license. The acceptable values for this parameter are: GeneralLicenseStatement and MicrosoftVolumeLicenseStatement.

A general license statement contains information about the purchased licenses for any publisher. A Microsoft Volume License Statement (MVLS) license statement contains information about the license entitlements, or number of purchased licenses, for Microsoft products.

Type:ImportType
Accepted values:MicrosoftVolumeLicenseStatement, GeneralLicenseStatement
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MlsFilePath

Specifies the Universal Naming Convention (UNC) path of a valid XML-formatted licensing information file.

Type:String
Aliases:FileName, FilePath, ImportFilePath, Path
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Timeout

{{ Fill Timeout Description }}

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

System.Object