Start-AppvVirtualProcess
Start-AppvVirtualProcess is accessible with the help of AppVClient module. To configure AppVClient, go through this link.
Synopsis
Starts a virtual process.
Description
The Start-AppvVirtualProcess cmdlet starts a new virtual process.
Parameters
-AppvClientObject
Specifies an AppvClientPackage or AppvClientConnectionGroup object.
| Type: | Object |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ArgumentList
Specifies the arguments to be passed into the virtual process.
| Type: | String[] |
| Aliases: | Args |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Specifies the credential to start this process.
| Type: | PSCredential |
| Aliases: | RunAs |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FilePath
Specifies a file path.
| Type: | String |
| Aliases: | PSPath |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LoadUserProfile
Indicates that the cmdlet loads a user profile for use with the process.
| Type: | SwitchParameter |
| Aliases: | Lup |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoNewWindow
Indicates that the cmdlet attempts to keep the process in the same window instead of opening a new window.
| Type: | SwitchParameter |
| Aliases: | nnw |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RedirectStandardError
Redirects the stderr to the file specified.
| Type: | String |
| Aliases: | RSE |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RedirectStandardInput
Takes the stdinput from the file specified.
| Type: | String |
| Aliases: | RSI |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RedirectStandardOutput
Redirects the stdout to the file specified.
| Type: | String |
| Aliases: | RSO |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseNewEnvironment
Indicates that this cmdlet uses a new environment for the process.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Verb
Specifies a verb for the process.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Wait
Indicates that the cmdlet uses synchronous operation of the virtual process. The cmdlet waits to exit until the virtual process exits.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WindowStyle
Specifies what to do without a Process Window Style. The acceptable values for this parameter are:
- Normal. Display the normal window.
- Hidden. Launch a hidden window.
- Minimized. Launch a minimized window.
- Maximized. Launch a maximized window.
The default value is Normal.
| Type: | ProcessWindowStyle |
| Accepted values: | Normal, Hidden, Minimized, Maximized |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkingDirectory
Specifies working directory of the process.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Syntax
Start-AppvVirtualProcess [-FilePath] <String> [[-ArgumentList] <String[]>] [-Credential <PSCredential>] [-WorkingDirectory <String>] [-LoadUserProfile] [-NoNewWindow] [-PassThru] [-RedirectStandardError <String>] [-RedirectStandardInput <String>] [-RedirectStandardOutput <String>] [-Wait] [-UseNewEnvironment] -AppvClientObject <Object> [<CommonParameters>]
Start-AppvVirtualProcess [-FilePath] <String> [[-ArgumentList] <String[]>] [-WorkingDirectory <String>] [-PassThru] [-Verb <String>] [-Wait] [-WindowStyle <ProcessWindowStyle>] -AppvClientObject <Object> [<CommonParameters>]
——————-Example 1——————-
Start a virtual process in a virtual environment of a package
PS C:\> $AppVObj = Get-AppvClientPackage -Name “VPackage” PS C:\> Start-AppvVirtualProcess -FilePath “C:\Calc.exe” -AppvClientObject $AppVObj
The first command gets the client package named VPackage by using the Get-AppvClientPackage cmdlet. The command stores the result in the $AppVObj variable.
The second command starts a new virtual process for Calc.exe in virtual environment of in $AppVObj.
——————-Example 2——————-
Start a virtual process in a virtual environment of a connection group
PS C:\> $AppVObj = Get-AppvClientConnectionGroup -Name VConnectionGroup
PS C:\> Start-AppvVirtualProcess -FilePath “C:\Calc.exe” -AppvClientObject $AppVObj
The first command gets the client package named VPackage by using the Get-AppvClientConnectionGroup cmdlet. The command stores the result in the $AppVObj variable.
The second command starts a new virtual process for Calc.exe in the virtual environment of in $AppVObj.
You can check the Version, CommandType and Source of this cmdlet by giving below command.
Get-Command Start-AppvVirtualProcess
You can also read about
- Get-AppvClientConnectionGroup
- Get-AppvClientPackage
- Get-AppvVirtualProcess
