Edit

Add-WssUser

  • Reference
Module:
WSSCmdlets

Adds a new user account.

Syntax

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

Description

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

Examples

Example 1: Add a user

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

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

Parameters

-AccessLevel

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

Type:String
Accepted values:User, Administrator
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowRemoteAccess

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowVpnAccess

Indicates that the user can access the VPN server.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FirstName

Specifies the first name of a user.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupName

Specifies the name of a group.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LastName

Specifies the last name of a user.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies a user account name.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Password

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

Type:SecureString
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Microsoft.WindowsServerSolutions.Users.User

This cmdlet returns the user object created by this cmdlet.