< Back
Start-AppvVirtualProcess
Post
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
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