README.md

Posh-ghe

Powershell Module for GitHub Entreprise Administration

Description

The Posh-ghe Powershell package aim is to help Github Enterprise Server administration and management.
It uses Posh-SSH to be able to run linux commands remotely and the Octokit.net binary to be able to use the GitHub Server api with HTTP requests.

It allows you to :

• Send a ssh command on the GitHub Enterprise Server and get the result.
• Display / clear an announce message on the GitHub Enterprise Server.
• Suspend / unsuspend a user.
• Promote / demote a user.
• Send a mail using the GitHub Enterprise email client configuration.
• Get GitHub Enterprise configuration parameters
• Get GitHub Enterprise users directory.
• Get LDAP users directory.
• Synchronize GitHub users with LDAP directory.
• Get repository branches.
• Synchronize repository branches.

How to install

1. If you are running Windows 7.0, install Powershell 5.0

2. From Windows Command Line, install Posh-SSH:
   powershell -executionpolicy Bypass -command "Find-Module PoSH-SSH | Install-Module"

3. From Windows Command Line, install PsIni:
   powershell -executionpolicy Bypass -command "Find-Module PsIni | Install-Module"

4. Clone this repository
   git clone https://github.com/diagnostica-stago/Posh-ghe.git C:\Temp\Posh-ghe

5. From Powershell, import the module
   Import-Module C:\Temp\Posh-ghe.psd1

6. Have a look to Tests subdirectory to have an usage overview.

7. Have a look to the Wiki for further information.

ChangeLog

Version 0.1.2

• Octokit.net v.0.21.1
• Posh-SSH v1.7.7 or higher
• PsIni v1.2.0 or higher

Version 0.1.1

• Initial public version
• Octokit.net v.0.21.1
• Posh-SSH v1.7.7 or higher

Licenses

Posh-ghe

GNU General Public License v3.0
https://github.com/diagnostica-stago/Posh-ghe/blob/master/LICENSE

Octokit.net

MIT License
https://github.com/octokit/octokit.net/blob/master/LICENSE.txt

Posh-SSH

BSD 3-clause "New" or "Revised" License
https://github.com/darkoperator/Posh-SSH/blob/master/License.md