< Back

Start-AppvVirtualProcess

Tue Jan 29, 2019 9:24 pm

NAME Start-AppvVirtualProcess



SYNOPSIS

Starts a virtual process.





SYNTAX

Start-AppvVirtualProcess [-FilePath] <String> [[-ArgumentList] <String[]>] [-Credential <PSCredential>] [-LoadUserProfile] [-NoNewWindow]

[-PassThru] [-RedirectStandardError <String>] [-RedirectStandardInput <String>] [-RedirectStandardOutput <String>] [-UseNewEnvironment] [-Wait]

[-WorkingDirectory <String>] -AppvClientObject <Object> [<CommonParameters>]



Start-AppvVirtualProcess [-FilePath] <String> [[-ArgumentList] <String[]>] [-PassThru] [-Verb <String>] [-Wait] [-WindowStyle {Normal | Hidden |

Minimized | Maximized}] [-WorkingDirectory <String>] -AppvClientObject <Object> [<CommonParameters>]





DESCRIPTION

The Start-AppvVirtualProcess cmdlet starts a new virtual process.





PARAMETERS

-AppvClientObject <Object>

Specifies an AppvClientPackage or AppvClientConnectionGroup object.



Required? true

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-ArgumentList [<String[]>]

Specifies the arguments to be passed into the virtual process.



Required? false

Position? 2

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Credential [<PSCredential>]

Specifies the credential to start this process.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-FilePath <String>

Specifies a file path.



Required? true

Position? 1

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-LoadUserProfile [<SwitchParameter>]

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



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-NoNewWindow [<SwitchParameter>]

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



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-PassThru [<SwitchParameter>]

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



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-RedirectStandardError [<String>]

Redirects the stderr to the file specified.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-RedirectStandardInput [<String>]

Takes the stdinput from the file specified.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-RedirectStandardOutput [<String>]

Redirects the stdout to the file specified.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-UseNewEnvironment [<SwitchParameter>]

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



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Verb [<String>]

Specifies a verb for the process.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Wait [<SwitchParameter>]

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



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-WindowStyle [<ProcessWindowStyle>]

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.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-WorkingDirectory [<String>]

Specifies working directory of the process.



Required? false

Position? named

Default value none

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 (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS









OUTPUTS









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.







RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=827732

Get-AppvClientConnectionGroup

Get-AppvClientPackage

Get-AppvVirtualProcess