Edit

Share via

Start-AppvVirtualProcess

Module:
AppvClient Module

Starts a virtual process.

Syntax

Default (Default) 

Start-AppvVirtualProcess
    [-FilePath] <String>
    [[-ArgumentList] <String[]>]
    -AppvClientObject <Object>
    [-Credential <PSCredential>]
    [-WorkingDirectory <String>]
    [-LoadUserProfile]
    [-NoNewWindow]
    [-PassThru]
    [-RedirectStandardError <String>]
    [-RedirectStandardInput <String>]
    [-RedirectStandardOutput <String>]
    [-Wait]
    [-UseNewEnvironment]
    [<CommonParameters>]

UseShellExecute 

Start-AppvVirtualProcess
    [-FilePath] <String>
    [[-ArgumentList] <String[]>]
    -AppvClientObject <Object>
    [-WorkingDirectory <String>]
    [-PassThru]
    [-Verb <String>]
    [-Wait]
    [-WindowStyle <ProcessWindowStyle>]
    [<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.

Parameter properties

Type:Object
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ArgumentList

Specifies the arguments to be passed into the virtual process.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:Args

Parameter sets

(All)
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Credential

Specifies the credential to start this process.

Parameter properties

Type:PSCredential
Default value:None
Supports wildcards:False
DontShow:False
Aliases:RunAs

Parameter sets

Default
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-FilePath

Specifies a file path.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:PSPath

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-LoadUserProfile

Indicates that the cmdlet loads a user profile for use with the process.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Lup

Parameter sets

Default
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-NoNewWindow

Indicates that the cmdlet attempts to keep the process in the same window instead of opening a new window.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:nnw

Parameter sets

Default
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RedirectStandardError

Redirects the stderr to the file specified.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:RSE

Parameter sets

Default
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RedirectStandardInput

Takes the stdinput from the file specified.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:RSI

Parameter sets

Default
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RedirectStandardOutput

Redirects the stdout to the file specified.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:RSO

Parameter sets

Default
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-UseNewEnvironment

Indicates that this cmdlet uses a new environment for the process.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Default
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Verb

Specifies a verb for the process.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UseShellExecute
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Wait

Indicates that the cmdlet uses synchronous operation of the virtual process. The cmdlet waits to exit until the virtual process exits.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:ProcessWindowStyle
Default value:None
Accepted values:Normal, Hidden, Minimized, Maximized
Supports wildcards:False
DontShow:False

Parameter sets

UseShellExecute
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WorkingDirectory

Specifies working directory of the process.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.