New-DSUser
Synopsis
Create a new user
Syntax
__AllParameterSets
New-DSUser -Username <string> [-AuthenticationType <ServerUserType>] [-UserType <UserType>]
[-UserLicenceType <Object>] [-Password <string>] [-FirstName <string>] [-LastName <string>]
[-Email <string>] [-Language <string>] [-Enabled <bool>]
[-UserMustChangePasswordAtNextLogin <bool>] [-CompanyName <string>] [-JobTitle <string>]
[-Department <string>] [-GravatarEmail <string>] [-Address <string>] [-State <string>]
[-CountryName <string>] [-Phone <string>] [-Workphone <string>] [-CellPhone <string>]
[-Fax <string>] [-HasAccessRDM <bool>] [-HasAccessWebLogin <bool>] [-HasAccessLauncher <bool>]
[-HasAccessWeb <bool>] [-HasAccessCLI <bool>] [-AllowDragAndDrop <bool>]
[-CanViewInformations <bool>] [-CanViewGlobalLogs <bool>] [-CanImport <bool>] [-CanExport <bool>]
[-OfflineMode <OfflineMode>] [-AsLegacyResponse] [<CommonParameters>]Description
Create a new user with the supplied parameters.
Examples
Create a new read only user.
Parameters
-Address
Address of the user.
-AllowDragAndDrop
True by default.
-AsLegacyResponse
In versions prior to 2024.2, many DS cmdlets returned a ServerResponse object. Enabling this backward compatibility switch allows scripts developed for earlier versions to function correctly.
-AuthenticationType
Authentication type of the server user. Builtin (Devolutions Server) by default. Domain: authenticate using the Active Directory user account.
-CanExport
True by default.
-CanImport
True by default.
-CanViewGlobalLogs
True by default.
-CanViewInformations
True by default.
-CellPhone
Cell phone number to contact the user.
-CompanyName
Company name that employs the user.
-CountryName
Country of the user.
-Department
Department in which the user is working.
Email of the user.
-Enabled
Determine if the user is activated. True by default.
-Fax
Fax number to contact the user.
-FirstName
First name of the user.
-GravatarEmail
Gravatar email to obtain the user's avatar.
-HasAccessCLI
Allow the user to use to CLI (command line interface). True by default.
-HasAccessLauncher
Allow the user can open remote connections with Devolutions Launcher. True by default.
-HasAccessRDM
Allow the user to access to Devolutions Server through RDM. True by default.
-HasAccessWeb
Allow the user to use Devolutions Server web interface. True by default.
-HasAccessWebLogin
Allow the user to auto fill username and passwords on websites with Devolutions Web Login. True by default.
-JobTitle
Job title of the user.
-Language
Language of the user's web interface. English by default.
-LastName
Last name of the user.
-OfflineMode
Offline mode. Read/Write by default.
-Password
Password of the user.
-Phone
Phone number to contact the user.
-State
State of the user.
-UserLicenceType
Select the type of the license that the user has: Default: Connection Management. | Connection Management: for users who open remote connections. | Password Management: for users who only use Devolutions Server as a password manager.
-UserMustChangePasswordAtNextLogin
Force the user to change the password next time they log on.
-Username
User login name.
-UserType
User type defining their rights. User by default. Choices: Administrator: grant full administrative rights to the user. | Read only user: grant only the View access to the user. | Restricted user: select which rights to grant to the user. | User: grant all basic rights to the user (Add, Edit, Delete).
-Workphone
Work phone number to contact the user.
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.
Notes
For more information, type "Get-Help New-DSUser -detailed". For technical information, type "Get-Help New-DSUser -full".
Last updated
Was this helpful?