New-CMWirelessProfileObject

New-CMWirelessProfileObject

Creates a profile that specifies settings for AMT-based computers on a wireless network.

Syntax

Parameter Set: NewWirelessProfileObject
New-CMWirelessProfileObject -ClientAuthenticationMethod <ClientAuthenticationMethodType> {EapTls | EapTtlsMschapv2 | Peapv0EapMschapv2} -ClientCertificateTemplate <String> -ClientCertificationAuthorityName <String> -ClientIssuingCertificationAuthority <String> -EncryptionMethod <EncryptionType> {AES | TKIP} -NetworkName <String> -ProfileName <String> -SecurityType <WirelessProfileSecurityType> {WPA2Enterprise | WPAEnterprise} -TrustedRootCertificate <X509Certificate2> [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The New-CMWirelessProfileObject cmdlet creates a Microsoft System Center 2012 SP1 Configuration Manager profile that specifies settings that Intel Active Management Technology (AMT)-based computers use on a wireless network. These settings must match the configuration on your Remote Authentication Dial-In User Service (RADIUS) server. System Center 2012 Configuration Manager cannot validate that these settings with your RADIUS server.

Parameters

-ClientAuthenticationMethod<ClientAuthenticationMethodType>

Specifies the client authentication method configured on your RADIUS server. The acceptable values for this parameter are:

-- EapTls. EAP-TLS.
-- EapTtlsMschapv2. EAP-TTLS/MSCHAPv2.
-- Peapv0EapMschapv2. PEAPv0/EAP-MSCHAPv2.

The default authentication method is EAP-TLS.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ClientCertificateTemplate<String>

Specifies a client certificate template.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ClientCertificationAuthorityName<String>

Specifies a certification authority for the client.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ClientIssuingCertificationAuthority<String>

Specifies an issuing certification authority for the client.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EncryptionMethod<EncryptionType>

Specifies the encryption method. This method is the same as the encryption method for your wireless network. The acceptable values for this parameter are: AES and TKIP. The default value for this parameter is AES.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-NetworkName<String>

Specifies the name of your wireless network, also known as the service set identifier (SSID). This name cannot exceed 32 characters.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ProfileName<String>

Specifies a name for this profile. Use alphanumeric characters only, start the name with a letter, and do not exceed 32 characters.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SecurityType<WirelessProfileSecurityType>

Specifies the security type for your wireless network. The acceptable values for this parameter are: WPA2Enterprise and WPAEnterprise. The default value for this parameter is WPA2Enterprise.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-TrustedRootCertificate<X509Certificate2>

Specifies the trusted root certificate that the RADIUS server uses as its server authentication certificate.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?

false

Position?

named

Default Value

false

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 (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.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Create a profile for AMT-based computers on a wireless network

This command creates a profile for Intel Active Management Technology (AMT)-based computers on a wireless network. The command specifies security settings, such as the client authentication method, information necessary for certificates, and wireless network configuration. These settings must match the settings for the Remote Authentication Dial-In User Service (RADIUS) server and wireless network.

PS C:\> New-CMWirelessProfileObject -ClientAuthenticationMethod  EapTtlsMschapv2 -ClientCertificateTemplate "Contoso Wireless User"  -ClientCertificationAuthorityName "Contoso CA 1" -ClientIssuingCertificationAuthority "ContosoCA.Contoso.com" -EncryptionMethod TKIP -NetworkName "ContosoWireless" -ProfileName "WirelessLocalUser" -SecurityType WPA2Enterprise -TrustedRootCertificate "Contoso Root CA"

New-CMWiredProfileObject