Edit

Import-CMWirelessProfileConfigurationItem

  • Reference
Module:
ConfigurationManager

Imports a wireless profile configuration item.

Syntax

Import-CMWirelessProfileConfigurationItem
      [-Description <String>]
      -Name <String>
      -Path <String>
      [-Severity <NoncomplianceSeverity>]
      -SupportedPlatform <IResultObject[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Import-CMWirelessProfileConfigurationItem cmdlet imports an existing wireless profile item from a file.

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 wireless profile configuration item

PS XYZ:\><?xml version="1.0"?>
<WLANProfile xmlns="https://www.microsoft.com/networking/WLAN/profile/v1">
 <name>Open-WEP</name>
 <SSIDConfig>
  <SSID>
   <hex>4E455753534944283229</hex>
   <name>NEWSSID(2)</name>
  </SSID>
  <nonBroadcast>false</nonBroadcast>
 </SSIDConfig>
 <connectionType>ESS</connectionType>
 <connectionMode>auto</connectionMode>
 <autoSwitch>true</autoSwitch>
 <MSM>
  <security>
   <authEncryption>
    <authentication>open</authentication>
    <encryption>WEP</encryption>
    <useOneX>false</useOneX>
   </authEncryption>
   <preAuthThrottle>3</preAuthThrottle>
  </security>
 </MSM>
</WLANProfile>

PS XYZ:\> Import-CMWirelessProfileConfigurationItem -Name "Wireless2" -Description "Imported wireless profile" -Path "c:\WLanProfile.xml" -SupportedPlatform (Get-CMSupportedPlatform -Name "*Windows*10*" -Fast)

The first section provides xml content for the wireless profile. Save this content to "C:\WLanProfile.xml".

The command gets the supported platforms for Windows 10, and imports the wireless profile named WLanProfile.xml, naming it Wireless2. The Windows 10 platforms are provisioned with the wireless profile.

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

-Description

Specifies a description for the wireless profile.

Type:String
Position:Named
Default value:None
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

-Name

Specifies the name of a wireless profile.

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

-Path

Specifies the path to the file that contains the wireless profile to import.

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

-Severity

Specifies a non-compliance severity for reports. Valid values are:

  • None
  • Informational
  • Warning
  • Critical
  • CriticalWithEvent
Type:NoncomplianceSeverity
Accepted values:None, Informational, Warning, Critical, CriticalWithEvent
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SupportedPlatform

Specifies the supported platform object. The platform is provisioned with the wireless profile. To obtain a supported platform object, use the Get-CMSupportedPlatform cmdlet.

Type:IResultObject[]
Aliases:SupportedPlatforms
Position:Named
Default value:None
Required:True
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

IResultObject