Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/jdhitsolutions/PSRemoteOperations

A PowerShell module to invoke commands remotely through an out-of-band mechanism.
https://github.com/jdhitsolutions/PSRemoteOperations

powershell powershell-module

Last synced: about 1 month ago
JSON representation

A PowerShell module to invoke commands remotely through an out-of-band mechanism.

Host: GitHub
URL: https://github.com/jdhitsolutions/PSRemoteOperations
Owner: jdhitsolutions
License: mit
Created: 2018-10-02T19:29:28.000Z (almost 6 years ago)
Default Branch: master
Last Pushed: 2022-03-15T18:27:15.000Z (over 2 years ago)
Last Synced: 2024-05-28T02:20:06.515Z (4 months ago)
Topics: powershell, powershell-module
Language: PowerShell
Homepage:
Size: 148 KB
Stars: 65
Watchers: 9
Forks: 6
Open Issues: 1
Metadata Files:
- Readme: README.md
- Changelog: changelog.md
- License: license.txt

Awesome Lists containing this project

jimsghstars - jdhitsolutions/PSRemoteOperations - A PowerShell module to invoke commands remotely through an out-of-band mechanism. (PowerShell)

README

# PSRemoteOperations

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

This PowerShell module is designed to run commands on remote computers but _without_ using PowerShell remoting. It takes advantage of cloud services like Dropbox and OneDrive. The central concept is that you create a file with instructions about a command to run on a remote or target computer. The file includes the target computer name. The remote computer is monitoring a shared folder and when a matching file is detected the operation is invoked. The shared or common folder is managed by the cloud service of your choice.

You can install the latest version from the PowerShell Gallery:

```powershell
Install-Module PSRemoteOperations [-scope currentUser]
```

See [About_PSRemoteOperations](docs/about_PSRemoteOperations.md) for more detail. Pay close attention to the details on defining values for `$PSRemoteOpPath` and `$PSRemoteOpArchive`.

Or check out the individual commands:

+ [Get-PSRemoteOperationResult](docs/Get-PSRemoteOperation.md)
+ [Get-PSRemoteOperationResult](docs/Get-PSRemoteOperationResult.md)
+ [Invoke-PSRemoteOperation](docs/Invoke-PSRemoteOperation.md)
+ [New-PSRemoteOperation](docs/New-PSRemoteOperation.md)
+ [Register-PSRemoteOperationWatcher](docs/Register-PSRemoteOperationWatcher.md)
+ [Wait-PSRemoteOperation](docs/Wait-PSRemoteOperation.md)
+ [New-PSRemoteOperationForm](docs/New-PSRemoteOperationForm.md)
+ [Register-PSRemoteOpPath](docs/Register-PSRemoteOpPath.md)
+ [Import-PSRemoteOpPath](docs/Import-PSRemoteOpPath.md)

## Graphical Interface

The module includes a command called [New-PSRemoteOperationForm](docs/New-PSRemoteOperationForm.md). This is intended to provide an easy way to setup a new remote operation file. You launch the form from the PowerShell prompt.

```powershell
PS C:\> New-PSRemoteOperationForm
```

![RemoteOperationForm](assets/new-remoteop-form.png)

This should work fine for simple script blocks. For anything more complicated, it is recommended that you use a shared script file.

## Cross-Platform and PowerShell Core

The long-term goal is to ensure that this module will work cross-platform and in PowerShell 7. Basic functionality should exist running this module on PowerShell 7, both in Windows and non-Windows environments. Support for CMS messages is limited to Windows platforms through the use of dynamic parameters. `Register-PSRemoteOperationWatcher` requires a Windows platform but should work under PowerShell 7. For non-Windows systems, you will have to write tooling for monitoring and execution using `Invoke-PSRemoteOperation`.

Beginning with v3.4.0, when you create a remote operation file with either `New-PSRemoteOperation` or `New-PSRemoteOperationForm`, you can specify a PowerShell version. The default is 5.1. If you use a `PSVersion` value of 7, the remote operation will run under `pwsh.exe`.

Last updated 2021-08-24 21:10:12Z