Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/mkellerman/invoke-commandas

Invoke Command As System/Interactive/GMSA/User on Local/Remote machine & returns PSObjects.
https://github.com/mkellerman/invoke-commandas

Last synced: about 1 month ago
JSON representation

Invoke Command As System/Interactive/GMSA/User on Local/Remote machine & returns PSObjects.

Host: GitHub
URL: https://github.com/mkellerman/invoke-commandas
Owner: mkellerman
License: mit
Created: 2018-01-05T15:40:45.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2023-05-05T17:35:32.000Z (about 1 year ago)
Last Synced: 2024-02-08T23:35:19.535Z (5 months ago)
Language: PowerShell
Homepage: https://www.powershellgallery.com/packages/Invoke-CommandAs/
Size: 104 KB
Stars: 429
Watchers: 22
Forks: 69
Open Issues: 12
Metadata Files:
- Readme: README.md
- License: LICENSE.md

Lists

README

[![PSGallery Version](https://img.shields.io/powershellgallery/v/Invoke-CommandAs.svg?style=for-the-badge&label=PowerShell%20Gallery)](https://www.powershellgallery.com/packages/Invoke-CommandAs/)
[![PSGallery Downloads](https://img.shields.io/powershellgallery/dt/Invoke-CommandAs.svg?style=for-the-badge&label=Downloads)](https://www.powershellgallery.com/packages/Invoke-CommandAs/)

[![Azure Pipeline](https://img.shields.io/azure-devops/build/mkellerman/Invoke-CommandAs/8.svg?style=for-the-badge&label=Azure%20Pipeline)](https://dev.azure.com/mkellerman/Invoke-CommandAs/_build?definitionId=8)

# Invoke-CommandAs

```
.SYNOPSIS

Invoke Command as System/User on Local/Remote computer using ScheduleTask.

.DESCRIPTION

Invoke Command as System/User on Local/Remote computer using ScheduleTask.
ScheduledJob will be executed with current user credentials if no -AsUser or -AsSystem is provided.

Using ScheduledJob as they are ran in the background and the output can be retreived by any other process.
Using ScheduledTask to Run the ScheduledJob, since you can allow Tasks to run as System or provide any credentials.

Because the ScheduledJob is executed by the Task Scheduler, it is invoked locally as a seperate process and not from within the current Powershell Session.
Resolving the Double Hop limitations by Powershell Remote Sessions.

```
## Examples

```powershell
# Execute Locally.
Invoke-CommandAs -ScriptBlock { Get-Process }

# Execute As System.
Invoke-CommandAs -ScriptBlock { Get-Process } -AsSystem

# Execute As a GMSA.
Invoke-CommandAs -ScriptBlock { Get-Process } -AsGMSA 'domain\gmsa$'

# Execute As Credential of another user.
Invoke-CommandAs -ScriptBlock { Get-Process } -AsUser $Credential

# Execute As Interactive session of another user.
Invoke-CommandAs -ScriptBlock { Get-Process } -AsInteractive 'username'

```
### You can execute all the same commands as above against a remote machine.
### Use -ComputerName/Credential or -Session to authenticate
```powershell
# Execute Remotely using ComputerName/Credential.
Invoke-CommandAs -ComputerName 'VM01' -Credential $Credential -ScriptBlock { Get-Process }

# Execute Remotely using Session.
Invoke-CommandAs -Session $PSSession -ScriptBlock { Get-Process }

# Execute Remotely using PSSession and execute ScriptBlock as SYSTEM.
Invoke-CommandAs -Session $PSSession -ScriptBlock { Get-Process } -AsSystem

# Execute Remotely on multiple Computers at the same time.
Invoke-CommandAs -ComputerName 'VM01', 'VM02' -Credential $Credential -ScriptBlock { Get-Process }

# Execute Remotely as Job.
Invoke-CommandAs -Session $PSSession -ScriptBlock { Get-Process } -AsJob
```

## How to see if it works:
```powershell
$ScriptBlock = { [System.Security.Principal.Windowsidentity]::GetCurrent() }
Invoke-CommandAs -ScriptBlock $ScriptBlock -AsSystem
```

## Install Module (PSv5):
```powershell
Install-Module -Name Invoke-CommandAs
```

## Install Module (PSv4 or earlier):
```
Copy Invoke-CommandAs folder to:
C:\Program Files\WindowsPowerShell\Modules\Invoke-CommandAs
```

## Import Module directly from GitHub:
```
$WebClient = New-Object Net.WebClient
$WebClient.DownloadString("https://raw.githubusercontent.com/mkellerman/Invoke-CommandAs/master/Invoke-CommandAs/Private/Invoke-ScheduledTask.ps1") | Set-Content -Path ".\Invoke-ScheduledTask.ps1"
$WebClient.DownloadString("https://raw.githubusercontent.com/mkellerman/Invoke-CommandAs/master/Invoke-CommandAs/Public/Invoke-CommandAs.ps1") | Set-Content -Path ".\Invoke-CommandAs.ps1"
Import-Module ".\Invoke-ScheduledTask.ps1"
Import-Module ".\Invoke-CommandAs.ps1"
```
One liner (dont write to disk):
```
"Public/Invoke-CommandAs.ps1", "Private/Invoke-ScheduledTask.ps1" | % {
. ([ScriptBlock]::Create((New-Object Net.WebClient).DownloadString("https://raw.githubusercontent.com/mkellerman/Invoke-CommandAs/master/Invoke-CommandAs/${_}")))
}
```