Edit

Share via


New-NpsRadiusClient

Creates a RADIUS client.

Syntax

Default (Default)

New-NpsRadiusClient
    [-Name] <String>
    [-Address] <String>
    [-AuthAttributeRequired <Boolean>]
    [-SharedSecret <String>]
    [-VendorName <String>]
    [-Disabled]
    [<CommonParameters>]

Description

The New-NpsRadiusClient cmdlet creates a Remote Authentication Dial-In User Service (RADIUS) client. A RADIUS client uses a RADIUS server to manage authentication, authorization, and accounting requests that the client sends. A RADIUS client can be an access server, such as a dial-up server or wireless access point, or a RADIUS proxy.

Note

The NPS Server service must be restarted after you run the New-NpsRadiusClient cmdlet.

Examples

Example 1: Add a new RADIUS client

PS C:\>New-NpsRadiusClient -Address "10.0.0.200" -Name "WirelessAP" -SharedSecret "9vq7822hFsJ8rm"

This command adds a wireless access point as a RADIUS client to the NPS configuration. This RADIUS client has the IP address 10.0.0.200, the name WirelessAP, an enabled state, and a shared secret of 9vq7822hFsJ8rm.

Parameters

-Address

Specifies a fully qualified domain name (FQDN) or IP address of the RADIUS client.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-AuthAttributeRequired

Indicates whether the server has enabled verification for Access-Request messages. The default value is $False, which means disabled.

Parameter properties

Type:Boolean
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:True
Value from remaining arguments:False

-Disabled

Indicates whether the RADIUS client is disabled.

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

-Name

Specifies a name for the RADIUS client. This name must be unique.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SharedSecret

Specifies a shared secret key that is configured at the RADIUS client. Windows ServerĀ® 2012 uses the shared secret key to validate messages between the RADIUS client and NPS.

Parameter properties

Type:String
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:True
Value from remaining arguments:False

-VendorName

Specifies the RADIUS client vendor name. The default is RADIUS standard.

Parameter properties

Type:String
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:True
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.

Outputs

NpsRadiusClient