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 . 

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.