Set-RASAdminAccount

NAME

Set-RASAdminAccount

SYNOPSIS

Modifies Parallels RAS administrator account settings.

SYNTAX

Set-RASAdminAccount [-Id] <uint> [-Email <string>] [-Enabled <bool>] [-Mobile <string>] [-Notify {None | Email}] [-Permissions {PowerAdmin | RootAdmin | CustomAdmin}] [<CommonParameters>]

Set-RASAdminAccount [-InputObject] <AdminAccount> [-Email <string>] [-Enabled <bool>] [-Mobile <string>] [-Notify {None | Email}] [-Permissions {PowerAdmin | RootAdmin | CustomAdmin}] [<CommonParameters>]

Set-RASAdminAccount [[-Name] <string>] [-Email <string>] [-Enabled <bool>] [-Mobile <string>] [-Notify {None | Email}] [-Permissions {PowerAdmin | RootAdmin | CustomAdmin}] [<CommonParameters>]

DESCRIPTION

Modifies settings of a Parallels RAS administrator account.

For each setting, the cmdlet has a corresponding input parameter. To modify a setting, specify a corresponding parameter and its value.

PARAMETERS

-Name <string> Parallels RAS administrator user or group name.

        Required?                    false

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Id <uint> Parallels RAS administrator account ID.

To obtain the ID, use the Get-RASAdminAccount cmdlet.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

-InputObject <AdminAccount> An object representing a Parallels RAS administrator account.

To obtain the object, use the Get-RASAdminAccount command."

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       true (ByValue)

        Accept wildcard characters?  false

-Email <string> Parallels RAS administrator email address.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Mobile <string> Parallels RAS administrator mobile phone number.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Enabled <bool> Enable or disable the specified administrator account.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Notify <AdminNotify> Specifies a method for system notifications. Possible values are: "None", "Email".

Possible values: None, Email

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-Permissions <PermissionType> Type of Permission

Possible values: PowerAdmin, RootAdmin, CustomAdmin

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

<CommonParameters>

        This cmdlet supports the common parameters: Verbose, Debug,

        ErrorAction, ErrorVariable, WarningAction, WarningVariable,

        OutBuffer, PipelineVariable, and OutVariable. For more information, see 

        about_CommonParameters documentation. 

INPUTS

AdminAccount

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Set-RASAdminAccount -Name "Jane" -Enable $False

Disables the specified administrator account.

---------- EXAMPLE 2 ----------

Set-RASAdminAccount -Id 3 -Enable $False

Disables an administrator account specified by ID.

To obtain IDs of administrator accounts, use the Get-RASAdminAccount cmdlet. ---------- EXAMPLE 3 ----------

Set-RASAdminAccount $Admin -Enable $True

Enables an administrator account specified by the $Admin variable, which is an object of type RASAdminAccount.

The object is obtained using the Get-RASAdminAccount cmdlet. ---------- EXAMPLE 4 ----------

Get-RASAdminAccount -Id 3 | Set-RASAdminAccount -Enable $True

Enables an administrator account represented by a RASAdminAccount object obtained from the pipeline output.

Last updated

© 2024 Parallels International GmbH. All rights reserved.