Start-ChocolateyProcessAsAdmin

NOTE: Administrative Access Required.

Runs a process with administrative privileges. If -ExeToRun is not
specified, it is run with PowerShell.

Syntax

Start-ChocolateyProcessAsAdmin `
  [-Statements <String[]>] `
  [-ExeToRun <String>] `
  [-Elevated] `
  [-Minimized] `
  [-NoSleep] `
  [-ValidExitCodes <Object>] `
  [-WorkingDirectory <String>] `
  [-SensitiveStatements <String>] `
  [-IgnoredArguments <Object[]>] [<CommonParameters>]

Notes

This command will assert UAC/Admin privileges on the machine.

Starting in 0.9.10, will automatically call Set-PowerShellExitCode to
set the package exit code in the following ways:

Aliases Start-ChocolateyProcess and Invoke-ChocolateyProcess
available in 0.10.2+.

Aliases

Invoke-ChocolateyProcess
Start-ChocolateyProcess

Examples

EXAMPLE 1

Start-ChocolateyProcessAsAdmin -Statements "$msiArgs" -ExeToRun 'msiexec'

EXAMPLE 2

Start-ChocolateyProcessAsAdmin -Statements "$silentArgs" -ExeToRun $file

EXAMPLE 3

Start-ChocolateyProcessAsAdmin -Statements "$silentArgs" -ExeToRun $file -ValidExitCodes @(0,21)

EXAMPLE 4


# Run PowerShell statements
$psFile = Join-Path "$(Split-Path -parent $MyInvocation.MyCommand.Definition)" 'someInstall.ps1'
Start-ChocolateyProcessAsAdmin "& `'$psFile`'"

EXAMPLE 5

# This also works for cmd and is required if you have any spaces in the paths within your command
$appPath = "$env:ProgramFiles\myapp"
$cmdBatch = "/c `"$appPath\bin\installmyappservice.bat`""
Start-ChocolateyProcessAsAdmin $cmdBatch cmd 
# or more explicitly
Start-ChocolateyProcessAsAdmin -Statements $cmdBatch -ExeToRun "cmd.exe"

Inputs

None

Outputs

None

Parameters

-Statements [<String[]>]

Arguments to pass to ExeToRun or the PowerShell script block to be
run.

Property Value
Aliases
Required? false
Position? 1
Default Value
Accept Pipeline Input? false

-ExeToRun [<String>]

The executable/application/installer to run. Defaults to 'powershell'.

Property Value
Aliases
Required? false
Position? 2
Default Value powershell
Accept Pipeline Input? false

-Elevated

Indicate whether the process should run elevated.

Available in 0.10.2+.

Property Value
Aliases
Required? false
Position? named
Default Value True
Accept Pipeline Input? false

-Minimized

Switch indicating if a Windows pops up (if not called with a silent
argument) that it should be minimized.

Property Value
Aliases
Required? false
Position? named
Default Value False
Accept Pipeline Input? false

-NoSleep

Used only when calling PowerShell - indicates the window that is opened
should return instantly when it is complete.

Property Value
Aliases
Required? false
Position? named
Default Value False
Accept Pipeline Input? false

-ValidExitCodes [<Object>]

Array of exit codes indicating success. Defaults to @(0).

Property Value
Aliases
Required? false
Position? named
Default Value @(0)
Accept Pipeline Input? false

-WorkingDirectory [<String>]

The working directory for the running process. Defaults to
Get-Location.

Available in 0.10.1+.

Property Value
Aliases
Required? false
Position? named
Default Value $(Get-Location)
Accept Pipeline Input? false

-SensitiveStatements [<String>]

Arguments to pass to ExeToRun that are not logged.

Note that only licensed versions of Chocolatey provide a way to pass
those values completely through without having them in the install
script or on the system in some way.

Available in 0.10.1+.

Property Value
Aliases
Required? false
Position? named
Default Value
Accept Pipeline Input? false

-IgnoredArguments [<Object[]>]

Allows splatting with arguments that do not apply. Do not use directly.

Property Value
Aliases
Required? false
Position? named
Default Value
Accept Pipeline Input? false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters http://go.microsoft.com/fwlink/p/?LinkID=113216 .

Function Reference

NOTE: This documentation has been automatically generated from Import-Module "$env:ChocolateyInstall\helpers\chocolateyInstaller.psm1" -Force; Get-Help Start-ChocolateyProcessAsAdmin -Full.

View the source for Start-ChocolateyProcessAsAdmin