Powershell Functions

[Hikedaya]

На самом деле такие моменты надо собирать, запоминать и ценить. Они как раз и показывают, что не напрасно занимаешься тем, чем занимаешься.

Есть у нас на работе один сервер, на котором с завидной регулярностью падает одна служба. Имя ее несущественно, главное то, что она таки должна работать. Информацию об этом ее паршивом поведении я уже давно передал людям, которые за нее отвечают. Решения пока нет, так что приходится ее банально поднимать руками.

Каждый раз заходить для этого на сервер - лениво. Даже воспользоваться mmc-оснастокй Services - тоже лениво. А самая главная засада в том, что даже если работать через любимый Powershell - имеющаяся там встроенная команда Start-Service не принимает в качестве параметра имя удаленного сервера, она работает только с локальной системой. Потому была написана простенькая функция, которая вызывается вообще без параметров и запускает на жестко забитом сервере жестко заданную по имени службу, используя механизм Invoke-Command. Примерно так:

function Start-RemoteService {

param(
    [string]$ComputerName=%COMPUTERNAME%,
    [string]$Name=%SERVICENAME%
)
    $startServiceCommand = {Start-Service -Name $args[0] -ErrorAction SilentlyContinue -PassThru}
    invoke-command -ComputerName $ComputerName -scriptblock $startServiceCommand -ArgumentList $Name
}

И она работала себе, жрать не просила.

В какой-то момент я понял, что неплохо бы было расширить ее с таким расчетом, чтобы запускать любую службу на любом сервере, куда можно дотянуться при помощи PS. Удобно же, закинул ее в личный модуль, повесил какой-нибудь короткий алиас, и все. Пара нажатых кнопок, пара имен. И не надо ждать, пока прогрузится либо полностью весь сеанс, либо оснастка. Консоль же PS у меня запущена всегда, это удобно.

Получилось нечто вот такое. Решил, что пора бы осваивать Advanced Functions и встроенный в них man. Заодно обучил функцию работать не только с именами служб, но и с их отображаемыми подписями, так что службу идентифицировать можно разными способами.

function Start-RemoteService {
<#
.SYNOPSIS
Start remote service
.DESCRIPTION
Start service on remote system. Service can be specified by its name or display name.
.PARAMETER ComputerName
The name of remote system.
.PARAMETER Name
Name of service to be started. Cannot be used with -DisplayName parameter.
.PARAMETER DisplayName
Display Name of service to be started. Cannot be used with -Name parameter.
.EXAMPLE
Start-RemoteService -ComputerName "Server1" -Name "DNSCache"

Start service with name "DNSCache" on server "Server1"
.EXAMPLE
Start-RemoteService -ComputerName "Server1" -DisplayName "DNS Client"

Start service with display name "DNS Client" on server "Server1"
#>

param(
    [Parameter(Mandatory=$True)]
    [ValidateNotNullorEmpty()]
        [string]$ComputerName,
    
    [Parameter(ParameterSetName="ServiceName",Mandatory=$True)]
    [ValidateNotNullorEmpty()]
        [string]$Name,
    
    [Parameter(ParameterSetName="ServiceDisplayName",Mandatory=$True)]
    [ValidateNotNullorEmpty()]
        [string]$DisplayName
)
    $output = $null

    #check parameters 
    if ($Name) {
        $getServiceCommand   = {Get-Service -ComputerName $ComputerName -Name $Name -ErrorAction SilentlyContinue}
        $startServiceCommand = {Start-Service -Name $args[0] -ErrorAction SilentlyContinue -PassThru}
    }
    if ($DisplayName) {
        $getServiceCommand   = {Get-Service -ComputerName $ComputerName -DisplayName $DisplayName -ErrorAction SilentlyContinue}
        $startServiceCommand = {Start-Service -DisplayName $args[0] -ErrorAction SilentlyContinue -PassThru}
    }
    
    #check remote service
    $service = Invoke-command -ScriptBlock $getServiceCommand
    if ($service) {
        if ($Service.status -eq "Running") {
            $output = write-host "Service $($service.name) already running" -ForegroundColor Yellow
        }
        else {
            if ($Name) {
                $output = invoke-command -ComputerName $ComputerName -scriptblock $startServiceCommand -ArgumentList $Name
            }

            if ($DisplayName) {
                $output = invoke-command -ComputerName $ComputerName -scriptblock $startServiceCommand -ArgumentList $DisplayName
            }
        }
    }
    else {
        $output = write-host "Service not found" -ForegroundColor Yellow
    }
    return $output
}

И показал ее своему коллеге. Посмотрел он на нее, после чего в чат выдал вот такое:
- Эээ... Get-service -ComputerName %SERVERNAME% -Name %SERVICENAME% | Start-Service

После чего настал мой черед выдать:
- @#$...

И дружно ржем. Потому что весь мой велосипед реально умещается в одну строку кода, если отказаться от проверки DisplayName.

И самая мякотка - того коллегу на Powershell именно я и подсадил где-то год назад

@музыка: Nicholas Gunn - Flight over North Rim

@настроение: клац-клац-клац

@темы: PowerShell, Scripting