PoshBot

PoshBot

Pipelines Azure	Actions GitHub	Documentation	Galerie PS	Licence

---

Prise en charge de PoshBot

PoshBot est un projet open source sous licence MIT. Un développement continu est rendu possible grâce au soutien de sponsors. Si vous souhaitez devenir sponsor, vous pouvez le faire via GitHub Sponsors ou Patreon.

Commanditaires Argent

---

Vous voulez des guides détaillés ? Découvrez ChatOps en toute simplicité sur Leanpub !

Introduction

PoshBot est un chatbot écrit en PowerShell. Il utilise largement les classes introduites dans PowerShell 5.0. Les modules PowerShell sont chargés dans PoshBot et deviennent instantanément disponibles sous forme de commandes de bot. PoshBot prend actuellement en charge la connexion à Slack pour vous offrir une incroyable qualité ChatOps.

Que peut faire PoshBot ?

À peu près tout ce que vous voulez :) Non sérieusement. PoshBot exécute des fonctions ou des applets de commande à partir de modules PowerShell. Utilisez PoshBot pour vous connecter aux serveurs et signaler l'état, déployer du code, exécuter des runbooks, interroger des API, etc. Si vous pouvez l'écrire dans PowerShell, PoshBot peut l'exécuter.

Documentation

Une documentation détaillée peut être trouvée sur ReadTheDocs.

Construire PoshBot

Voir Construire PoshBot pour obtenir de la documentation sur la façon de créer PoshBot à partir des sources.

Journal des modifications

Les modifications détaillées pour chaque version sont documentées dans les notes de version.

[YouTube] PowerShell Summit 2018 – Invoke-ChatOps : améliorez et changez votre culture avec le chat et PowerShell

Démarrage rapide

Pour commencer dès maintenant, procurez-vous un SLACK-API-TOKEN pour votre bot :

https://my.slack.com/services/new/bot

 # Install the module from PSGallery
Install-Module - Name PoshBot - Repository PSGallery

# Import the module
Import-Module - Name PoshBot

# Create a bot configuration
$botParams = @ {
    Name = ' name '
    BotAdmins = @ ( ' <SLACK-CHAT-HANDLE> ' )
    CommandPrefix = ' ! '
    LogLevel = ' Info '
    BackendConfiguration = @ {
        Name = ' SlackBackend '
        Token = ' <SLACK-API-TOKEN> '
    }
    AlternateCommandPrefixes = ' bender ' , ' hal '
}

$myBotConfig = New-PoshBotConfiguration @botParams

# Start a new instance of PoshBot interactively or in a job.
Start-PoshBot - Configuration $myBotConfig # -AsJob

Utilisation de base :

 # Create a Slack backend
$backendConfig = @ { Name = ' SlackBackend ' ; Token = ' <SLACK-API-TOKEN> ' }
$backend = New-PoshBotSlackBackend - Configuration $backendConfig

# Create a PoshBot configuration
$pbc = New-PoshBotConfiguration - BotAdmins @ ( ' <MY-SLACK-HANDLE> ' ) - BackendConfiguration $backendConfig

# Save configuration
Save-PoshBotConfiguration - InputObject $pbc - Path .PoshBotConfig.psd1

# Load configuration
$pbc = Get-PoshBotConfiguration - Path .PoshBotConfig.psd1

# Create an instance of the bot
$bot = New-PoshBotInstance - Configuration $pbc - Backend $backend

# Start the bot
$bot .Start ()

# Available commands
Get-Command - Module PoshBot

CommandType     Name                                               Version    Source
-----------     ----                                               -------    ------
Function        Get-PoshBot                                        0.12.0     poshbot
Function        Get-PoshBotConfiguration                           0.12.0     poshbot
Function        Get-PoshBotStatefulData                            0.12.0     poshbot
Function        New-PoshBotCardResponse                            0.12.0     poshbot
Function        New-PoshBotConfiguration                           0.12.0     poshbot
Function        New-PoshBotDiscordBackend                          0.12.0     poshbot
Function        New-PoshBotFileUpload                              0.12.0     poshbot
Function        New-PoshBotInstance                                0.12.0     poshbot
Function        New-PoshBotMiddlewareHook                          0.12.0     poshbot
Function        New-PoshBotScheduledTask                           0.12.0     poshbot
Function        New-PoshBotSlackBackend                            0.12.0     poshbot
Function        New-PoshBotTeamsBackend                            0.12.0     poshbot
Function        New-PoshBotTextResponse                            0.12.0     poshbot
Function        Remove-PoshBotStatefulData                         0.12.0     poshbot
Function        Save-PoshBotConfiguration                          0.12.0     poshbot
Function        Set-PoshBotStatefulData                            0.12.0     poshbot
Function        Start-PoshBot                                      0.12.0     poshbot
Function        Stop-Poshbot                                       0.12.0     poshbot