New-CMWiredProfileObject
New-CMWiredProfileObject
Creates a profile that specifies settings for AMT-based computers on a wired network.
Syntax
Parameter Set: NewWiredProfileObject
New-CMWiredProfileObject -ClientAuthenticationMethod <ClientAuthenticationMethodType> {EapTls | EapTtlsMschapv2 | Peapv0EapMschapv2} -ClientCertificateTemplate <String> -ClientCertificationAuthorityName <String> -ClientIssuingCertificationAuthority <String> -TrustedRootCertificate <X509Certificate2> [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The New-CMWiredProfileObject cmdlet creates a Microsoft System Center 2012 Configuration Manager profile that specifies settings that Intel Active Management Technology (Intel AMT)-based computers use on a wired 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 |
-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 wired network
This command creates a profile for Intel AMT-based computers on a wired network. The command specifies security settings, such as the client authentication method and information necessary for certificates. These settings must match the settings for the RADIUS server.
PS C:\> New-CMWiredProfileObject -ClientAuthenticationMethod EapTtlsMschapv2 -ClientCertificateTemplate "Contoso Wired User" -ClientCertificationAuthorityName "Contoso CA 1" -ClientIssuingCertificationAuthority "ContosoCA.Contoso.com" -TrustedRootCertificate "Contoso Root"