Set-RASAdminAccount

NAME

Set-RASAdminAccount

SYNOPSIS

Modifies Parallels RAS administrator account settings.

SYNTAX

Set-RASAdminAccount [-Id] <uint> [-AllowAllSites <bool>] [-AllowConnectionChanges <bool>] [-AllowDeviceManagementChanges <bool>] [-AllowInSites <Site[]>] [-AllowPolicyChanges <bool>] [-AllowPublishingChanges <bool>] [-AllowSessionManagement <bool>] [-AllowSiteChanges <bool>] [-AllowViewingPolicyInfo <bool>] [-AllowViewingReportingInfo <bool>] [-AllowViewingSiteInfo <bool>] [-Email <string>] [-Enabled <bool>] [-FullPermissions <bool>] [-Mobile <string>] [-Notify {None | Email}] [-Permissions {PowerAdmin | RootAdmin | CustomAdmin}] [<CommonParameters>]

Set-RASAdminAccount [-InputObject] <AdminAccount> [-AllowAllSites <bool>] [-AllowConnectionChanges <bool>] [-AllowDeviceManagementChanges <bool>] [-AllowInSites <Site[]>] [-AllowPolicyChanges <bool>] [-AllowPublishingChanges <bool>] [-AllowSessionManagement <bool>] [-AllowSiteChanges <bool>] [-AllowViewingPolicyInfo <bool>] [-AllowViewingReportingInfo <bool>] [-AllowViewingSiteInfo <bool>] [-Email <string>] [-Enabled <bool>] [-FullPermissions <bool>] [-Mobile <string>] [-Notify {None | Email}] [-Permissions {PowerAdmin | RootAdmin | CustomAdmin}] [<CommonParameters>]

Set-RASAdminAccount [[-Name] <string>] [-AllowAllSites <bool>] [-AllowConnectionChanges <bool>] [-AllowDeviceManagementChanges <bool>] [-AllowInSites <Site[]>] [-AllowPolicyChanges <bool>] [-AllowPublishingChanges <bool>] [-AllowSessionManagement <bool>] [-AllowSiteChanges <bool>] [-AllowViewingPolicyInfo <bool>] [-AllowViewingReportingInfo <bool>] [-AllowViewingSiteInfo <bool>] [-Email <string>] [-Enabled <bool>] [-FullPermissions <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

-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

-AllowSiteChanges <bool> Deprecated: use 'Set-RASPowerPermission' to set power admin permissions.

Enable or disable the "Allow Site changes" option.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-AllowPublishingChanges <bool> Deprecated: use 'Set-RASPowerPermission' to set power admin permissions.

Enable or disable the "Allow Publishing changes" option.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-AllowConnectionChanges <bool> Deprecated: use 'Set-RASPowerPermission' to set power admin permissions.

Enable or disable the "Allow Connection changes" option.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-AllowViewingReportingInfo <bool> Deprecated: use 'Set-RASPowerPermission' to set power admin permissions.

Enable or disable the "Allow viewing of RAS Reporting" option.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-AllowViewingSiteInfo <bool> Deprecated: use 'Set-RASPowerPermission' to set power admin permissions.

Enable or disable the "Allow viewing of Site Information" option.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-AllowViewingPolicyInfo <bool> Deprecated: use 'Set-RASPowerPermission' to set power admin permissions.

Enable or disable the "Allow viewing of Policy Information" option.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-AllowSessionManagement <bool> Deprecated: use 'Set-RASPowerPermission' to set power admin permissions.

Enable or disable the "Allow Session Management" option.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-AllowDeviceManagementChanges <bool> Deprecated: use 'Set-RASPowerPermission' to set power admin permissions.

Enable or disable the "Allow Device Management changes" option.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-AllowPolicyChanges <bool> Deprecated: use 'Set-RASPowerPermission' to set power admin permissions.

Enable or disable the "Allow Policy changes" option.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-AllowAllSites <bool> Deprecated: use 'Set-RASPowerPermission' to set power admin permissions.

Enable or disable the "All Sites" option. If enabled, the administrator can manage all sites in the farm. Otherwise, sites can be specified individually.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

-AllowInSites <Site[]> Deprecated: use 'Set-RASPowerPermission' to set power admin permissions.

A list of site names (a string array) which the administrator should be allowed to manage.

        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.

RELATED LINKS

PreviousSet-RASADIntegrationSettingsNextSet-RASAgentLogLevel

Last updated

© 2024 Parallels International GmbH. All rights reserved.