Set-RASVDIGuest

Set-RASVDIGuest

Modifies guest VM settings.

Set-RASVDIGuest [- ProviderId ] <uint> [- Id ] <string> [- ComputerName <string> ] [- GroupType < UserGroupType > {RDUsers | Administrators}] [- IgnoreGuest <bool> ] [- InheritDefVDIActionSettings <bool> ] [- InheritDefVDISecuritySettings <bool> ] [- InheritDefVDIUserProfileSettings <bool> ] [- IsUsersGrantedRDPermissions <bool> ] [- PerformAction < PerformAction > {DoNothing | Shutdown | Restart | Suspend | Delete | Unassign | Recreate}] [- PerformActionAfterSec <uint> ] [- Port <uint> ] [- SessionAction < SessionAction > {Disconnect | Logoff}] [- SessionResetTimeoutSec <uint> ] [- Technology < UserProfileTech > {DoNotManage | UPD | FSLogixProfileContainer}] [ < CommonParameters > ]

Set-RASVDIGuest [- InputObject ] < VDIGuest > [- ComputerName <string> ] [- GroupType < UserGroupType > {RDUsers | Administrators}] [- IgnoreGuest <bool> ] [- InheritDefVDIActionSettings <bool> ] [- InheritDefVDISecuritySettings <bool> ] [- InheritDefVDIUserProfileSettings <bool> ] [- IsUsersGrantedRDPermissions <bool> ] [- PerformAction < PerformAction > {DoNothing | Shutdown | Restart | Suspend | Delete | Unassign | Recreate}] [- PerformActionAfterSec <uint> ] [- Port <uint> ] [- SessionAction < SessionAction > {Disconnect | Logoff}] [- SessionResetTimeoutSec <uint> ] [- Technology < UserProfileTech > {DoNotManage | UPD | FSLogixProfileContainer}] [ < CommonParameters > ]

Modifies settings of a guest VM.

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

- ProviderId <uint>
The ID of a Provider server on which the target VM resides.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

- Id <string>
The ID of the target guest VM.

        Required?                    true

        Position?                    1

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- InputObject < VDIGuest >
An object of the VDIGuest representing the target VM.

To obtain the object, use the Get-VDIGuest cmdlet.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       true (ByValue)

        Accept wildcard characters?  false

- IgnoreGuest <bool>
Ignore the specified guest VM in a site.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- ComputerName <string>
A computer name.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- Port <uint>
Specifies the port number for the RAS Guest Agent.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- InheritDefVDIActionSettings <bool>
Inherit Default VDI Action Settings for the specified guest VM.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- InheritDefVDISecuritySettings <bool>
Inherit Default VDI Security Settings for the specified guest VM.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- InheritDefVDIUserProfileSettings <bool>
Inherit Default VDI User Profile Settings for the specified guest VM.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- SessionResetTimeoutSec <uint>
Reset session after (in seconds).

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- SessionAction < SessionAction >
Session change state.

Possible values: Disconnect, Logoff

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- PerformAction < PerformAction >
Perform action on session change.

Possible values: DoNothing, Shutdown, Restart, Suspend, Delete, Unassign, Recreate

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- PerformActionAfterSec <uint>
Perform action after (in seconds).

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- IsUsersGrantedRDPermissions <bool>
Grant users RD permission.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- GroupType < UserGroupType >
Group type that will get RD premission.

Possible values: RDUsers, Administrators

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- Technology < UserProfileTech >
Specifies the 'User Profile Technology' value.

Possible values: DoNotManage, UPD, FSLogixProfileContainer

        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. 

VDIGuest

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

Set-RASVDIGuest -ProviderId 3 -Id 42311235-09c5-ca15-337d-b9723015edf0 -InheritDefVDISecuritySettings $True

Inherits the default security settings for the guest VM specified by the Provider ID and the VM ID.

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

Set-RASVDIGuest $VDIGuest -InheritDefVDIActionSettings $True

Inherits the default action settings for the guest VM specified by the $VDIGuest variable, which is an object of type VDIGuest.

The object is obtained using the Get-RASVDIGuest cmdlet.

---------- EXAMPLE 3 ----------

Get-RASVDIGuest -ProviderId 3 -Id 42311235-09c5-ca15-337d-b9723015edf0 | Set-RASVDIGuest -InheritDefVDISecuritySettings $True

Inherits the default security settings for the guest VM represented by a VDIGuest object obtained from the pipeline output.