Add-WssUser

Add-WssUser

Adds a new user account.

Syntax

Parameter Set: Default
Add-WssUser [-Name] <String> [-Password] <SecureString> [-AccessLevel <String> ] [-AllowRemoteAccess] [-AllowVpnAccess] [-FirstName <String> ] [-LastName <String> ] [ <CommonParameters>]

Detailed Description

The Add-WssUser cmdlet adds a new user account to the server. Use the parameters to grant the account access to services or set access levels.

Parameters

-AccessLevel<String>

Specifies the access level for a user. To give the user administrative access, specify Administrator; otherwise, specify User for a standard user.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-AllowRemoteAccess

Indicates that the user can access the Remote Web Access website.

Aliases	none
Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-AllowVpnAccess

Indicates that the user can access the VPN server.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-FirstName<String>

Specifies the first name of a user.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-LastName<String>

Specifies the last name of a user.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Name<String>

Specifies a user account name.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Password<SecureString>

Specifies a password for a user, as a secure string.

Aliases	none
Required?	true
Position?	2
Default Value	none
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.

• User

Examples

Example 1: Add a user

This command adds a user with administrative access and remote web access to a server.

PS C:\> Add-WssUser -AccessLevel "Administrator" -Name "SarahJones" -FirstName "Sarah" -LastName "Jones" -AllowRemoteAccess

Related topics

Get-WssUser

Import-WssUser

Remove-WssUser

Sync-WssUser