Start-AppvVirtualProcess

Starts a virtual process.

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>]

Description

The Start-AppvVirtualProcess cmdlet starts a new virtual process.

Examples

Example 1: Start a virtual process in a virtual environment of a package

PS C:\> $AppVObj = Get-AppvClientPackage -Name "MyPackage" 
PS C:\> Start-AppvVirtualProcess -FilePath "C:\Calc.exe" -AppvClientObject $AppVObj

The first command gets the client package named MyPackage 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 MyConnectionGroup
PS C:\> Start-AppvVirtualProcess -FilePath "C:\Calc.exe" -AppvClientObject $AppVObj

The first command gets the client package named MyPackage 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.

Parameters

-AppvClientObject

Specifies an AppvClientPackage or AppvClientConnectionGroup object.

Type:Object
Position:Named
Default value:None
Required:True
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilePath

Specifies a file path.

Type:String
Aliases:PSPath
Position:0
Default value:None
Required:True
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
Required:False
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
Required:False
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
Required:False
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
Required:False
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
Required:False
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Verb

Specifies a verb for the process.

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkingDirectory

Specifies working directory of the process.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False