Set-RASAdminAccount

NAME

Set-RASAdminAccount

SYNOPSIS

Modifies Parallels RAS administrator account settings.

SYNTAX

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

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

Set-RASAdminAccount [-InputObject] <RASAdminAccount> [-Email <string>] [-Enabled <bool>] [-FullPermissions <bool>] [-Mobile <string>] [-Notify <AdminNotify> {None | Email}] [-Permissions <PermissionType> {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 <RASAdminAccount>
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>
Enables or disables the specified administrator account. 

        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-Enable <bool>
Enables or disables the specified administrator account.

This is an alias of the Enabled parameter. 

        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

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

Possible values: None, Email

This is an alias of the Notify parameter. 

        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-Permissions <PermissionType>
Possible values: PowerAdmin, RootAdmin, CustomAdmin 

        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-FullPermissions <bool>
Whether to grant the specified administrator full permissions in the farm. If set to False, permissions can be set individually. 

        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

RASAdminAccount

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.

RELATED LINKS