Export (0) Print
Expand All
Expand Minimize

Add-WssUser

Windows Server 2012 R2 and Windows 8.1

Updated: December 18, 2013

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Add-WssUser

Adds a new user account.

Syntax

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




Detailed Description

The Add-WssUser cmdlet adds a new user account to the Windows Server 2012 Essentials 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

-GroupName<String>

Specifies the name of a group.


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.

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.

  • Microsoft.WindowsServerSolutions.Users.User

    This cmdlet returns the user object created by this cmdlet.


Examples

Example 1: Add a user

This command adds a user with administrative access and remote web access to a Windows Server 2012 Essentials server.


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

Related topics


Get-WssUser

Import-WssUser

Remove-WssUser

Sync-WssUser

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft