Invoke-Command

Invoke-Command
    [-ScriptBlock] <ScriptBlock>
    [-StrictMode <Version>]
    [-NoNewScope]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [[-Session] <PSSession[]>]
    [-FilePath] <String>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-HideComputerName]
    [-JobName <String>]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [[-Session] <PSSession[]>]
    [-ScriptBlock] <ScriptBlock>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-HideComputerName]
    [-JobName <String>]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [[-ComputerName] <String[]>]
    [-FilePath] <String>
    [-Credential <PSCredential>]
    [-Port <Int32>]
    [-UseSSL]
    [-ConfigurationName <String>]
    [-ApplicationName <String>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-InDisconnectedSession]
    [-SessionName <String[]>]
    [-HideComputerName]
    [-JobName <String>]
    [-SessionOption <PSSessionOption>]
    [-Authentication <AuthenticationMechanism>]
    [-EnableNetworkAccess]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [[-ComputerName] <String[]>]
    [-ScriptBlock] <ScriptBlock>
    [-Credential <PSCredential>]
    [-Port <Int32>]
    [-UseSSL]
    [-ConfigurationName <String>]
    [-ApplicationName <String>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-InDisconnectedSession]
    [-SessionName <String[]>]
    [-HideComputerName]
    [-JobName <String>]
    [-SessionOption <PSSessionOption>]
    [-Authentication <AuthenticationMechanism>]
    [-EnableNetworkAccess]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Invoke-Command
    [[-ConnectionUri] <Uri[]>]
    [-ScriptBlock] <ScriptBlock>
    [-Credential <PSCredential>]
    [-ConfigurationName <String>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-InDisconnectedSession]
    [-HideComputerName]
    [-JobName <String>]
    [-AllowRedirection]
    [-SessionOption <PSSessionOption>]
    [-Authentication <AuthenticationMechanism>]
    [-EnableNetworkAccess]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Invoke-Command
    [[-ConnectionUri] <Uri[]>]
    [-FilePath] <String>
    [-Credential <PSCredential>]
    [-ConfigurationName <String>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-InDisconnectedSession]
    [-HideComputerName]
    [-JobName <String>]
    [-AllowRedirection]
    [-SessionOption <PSSessionOption>]
    [-Authentication <AuthenticationMechanism>]
    [-EnableNetworkAccess]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [-ScriptBlock] <ScriptBlock>
    [-VMId] <Guid[]>
    -Credential <PSCredential>
    [-ConfigurationName <String>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-HideComputerName]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [-ScriptBlock] <ScriptBlock>
    -Credential <PSCredential>
    -VMName <String[]>
    [-ConfigurationName <String>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-HideComputerName]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [-FilePath] <String>
    [-VMId] <Guid[]>
    -Credential <PSCredential>
    [-ConfigurationName <String>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-HideComputerName]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [-FilePath] <String>
    -Credential <PSCredential>
    -VMName <String[]>
    [-ConfigurationName <String>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-HideComputerName]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [-ScriptBlock] <ScriptBlock>
    -HostName <String[]>
    [-Port <Int32>]
    [-AsJob]
    [-HideComputerName]
    [-JobName <String>]
    [-UserName <String>]
    [-KeyFilePath <String>]
    [-Subsystem <String>]
    [-ConnectingTimeout <Int32>]
    [-SSHTransport]
    [-Options <Hashtable>]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [-ScriptBlock] <ScriptBlock>
    -ContainerId <String[]>
    [-ConfigurationName <String>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-HideComputerName]
    [-JobName <String>]
    [-RunAsAdministrator]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [-FilePath] <String>
    -ContainerId <String[]>
    [-ConfigurationName <String>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-HideComputerName]
    [-JobName <String>]
    [-RunAsAdministrator]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [-ScriptBlock] <ScriptBlock>
    -SSHConnection <Hashtable[]>
    [-AsJob]
    [-HideComputerName]
    [-JobName <String>]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [-FilePath] <String>
    -HostName <String[]>
    [-AsJob]
    [-HideComputerName]
    [-UserName <String>]
    [-KeyFilePath <String>]
    [-Subsystem <String>]
    [-ConnectingTimeout <Int32>]
    [-SSHTransport]
    [-Options <Hashtable>]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [-FilePath] <String>
    -SSHConnection <Hashtable[]>
    [-AsJob]
    [-HideComputerName]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Командлет Invoke-Command выполняет команды на локальном или удаленном компьютере и возвращает все выходные данные из команд, включая ошибки. С помощью одной Invoke-Command команды можно выполнять команды на нескольких компьютерах.

Чтобы выполнить одну команду на удаленном компьютере, используйте параметр ComputerName . Чтобы выполнить ряд связанных команд, которые совместно используют данные, используйте New-PSSession командлет для создания PSSession (постоянного подключения) на удаленном компьютере, а затем используйте для выполнения команды в Invoke-Command. Чтобы выполнить команду в отключенном сеансе, используйте параметр InDisconnectedSession . Чтобы выполнить команду в фоновом задании, используйте параметр AsJob .

Вы также можете использовать Invoke-Command на локальном компьютере блок скрипта запуска в качестве команды. PowerShell запускает блок скрипта сразу же в дочерней области текущей области.

Прежде чем выполнять Invoke-Command команды на удаленном компьютере, прочитайте about_Remote.

Начиная с PowerShell 6.0, вы можете использовать Secure Shell (SSH) для установления подключения и вызова команд на удаленных компьютерах. SSH необходимо установить на локальном компьютере, а удаленный компьютер должен быть настроен с конечной точкой PowerShell SSH. Преимущество удаленного сеанса PowerShell на основе SSH заключается в том, что он работает на нескольких платформах (Windows, Linux, macOS). Для сеанса на основе SSH используются параметры HostName или SSHConnection , чтобы указать удаленный компьютер и соответствующие сведения о подключении. Дополнительные сведения о настройке удаленного взаимодействия PowerShell SSH см. в статье о удаленном взаимодействии PowerShell по протоколу SSH.

Некоторые примеры кода используют сложение для уменьшения длины строки. Дополнительные сведения см. в about_Splatting.

В этом примере выполняется Test.ps1 скрипт на компьютере Server01.

Invoke-Command -FilePath C:\scripts\test.ps1 -ComputerName Server01

Параметр FilePath указывает скрипт, расположенный на локальном компьютере. Скрипт выполняется на удаленном компьютере и результаты возвращаются на локальный компьютер.

В этом примере выполняется Get-Culture команда на удаленном компьютере Server01.

Invoke-Command -ComputerName Server01 -Credential Domain01\User01 -ScriptBlock {
    Get-Culture
}

Параметр ComputerName указывает имя удаленного компьютера. Параметр Credential используется для выполнения команды в контексте безопасности Domain01\User01, пользователя, имеющего разрешение на выполнение команд. Параметр ScriptBlock указывает команду, выполняемую на удаленном компьютере.

В ответ PowerShell запрашивает пароль и метод проверки подлинности для учетной записи User01. Затем она запускает команду на компьютере Server01 и возвращает результат.

В этом примере выполняется та же Get-Culture команда в сеансе с помощью постоянного подключения на удаленном компьютере с именем Server02.

$s = New-PSSession -ComputerName Server02 -Credential Domain01\User01
Invoke-Command -Session $s -ScriptBlock { Get-Culture }

Командлет New-PSSession создает сеанс на удаленном компьютере Server02 и сохраняет его в переменной $s . Как правило, сеанс создается только при выполнении ряда команд на удаленном компьютере.

Командлет Invoke-Command выполняет Get-Culture команду на сервере Server02. Параметр сеанса указывает сеанс, сохраненный в переменной $s .

В ответ PowerShell запускает команду в сеансе на компьютере Server02.

В этом примере сравниваются эффекты использования параметров ComputerName и Invoke-Command. В нем показано, как использовать сеанс для выполнения ряда команд, которые используют одни и те же данные.

Invoke-Command -ComputerName Server02 -ScriptBlock { $p = Get-Process powershell }
Invoke-Command -ComputerName Server02 -ScriptBlock { $p.VirtualMemorySize }
$s = New-PSSession -ComputerName Server02
Invoke-Command -Session $s -ScriptBlock { $p = Get-Process powershell }
Invoke-Command -Session $s -ScriptBlock { $p.VirtualMemorySize }

17930240

Первые две команды используют для выполнения команд на удаленном компьютере Server02. Первая команда использует Get-Process командлет, чтобы получить процесс PowerShell на удаленном компьютере и сохранить его в переменной $p . Вторая команда получает значение свойства VirtualMemorySize процесса PowerShell.

При использовании параметра ComputerName PowerShell создает новый сеанс для выполнения команды. Сеанс закрывается после завершения команды. Переменная $p была создана в одном соединении, но она не существует в соединении, созданном для второй команды.

Проблема решена путем создания постоянного сеанса на удаленном компьютере, а затем выполнения обеих команд в одном сеансе.

Командлет New-PSSession создает постоянный сеанс на компьютере Server02 и сохраняет сеанс в переменной $s . Строки Invoke-Command , которые следуют за параметром session , используются для выполнения обеих команд в одном сеансе. Так как обе команды выполняются в одном сеансе, $p значение остается активным.

В этом примере показано, как выполнить команду, которая хранится в виде блока скрипта в переменной. При сохранении блока скрипта в переменной можно указать переменную в качестве значения параметра ScriptBlock .

$command = {
    Get-WinEvent -LogName PowerShellCore/Operational |
      Where-Object -FilterScript { $_.Message -like '*certificate*' }
}
Invoke-Command -ComputerName S1, S2 -ScriptBlock $command

Переменная $command сохраняет Get-WinEvent команду, отформатированную как блок скрипта. Выполняет Invoke-Command команду, хранящуюся на $command удаленных компьютерах S1 и S2.

В этом примере показано, как выполнять Invoke-Command одну команду на нескольких компьютерах.

$parameters = @{
  ComputerName      = 'Server01', 'Server02', 'TST-0143', 'localhost'
  ConfigurationName = 'MySession.PowerShell'
  ScriptBlock       = { Get-WinEvent -LogName PowerShellCore/Operational }
}
Invoke-Command @parameters

Параметр ComputerName указывает разделенный запятыми список имен компьютеров. Список компьютеров включает значение localhost, представляющее локальный компьютер. Параметр ConfigurationName указывает альтернативную конфигурацию сеанса. Параметр ScriptBlock запускается Get-WinEvent для получения журналов событий PowerShellCore или Operations с каждого компьютера.

В этом примере получается версия хост-программы PowerShell, работающей на удаленных компьютерах 200.

$version = Invoke-Command -ComputerName (Get-Content Machines.txt) -ScriptBlock {
    (Get-Host).Version
}

Так как выполняется только одна команда, вам не нужно создавать постоянные подключения к каждому из компьютеров. Вместо этого команда использует параметр ComputerName для указания компьютеров. Чтобы указать компьютеры, он использует Get-Content командлет для получения содержимого файла Machine.txt, файла имен компьютеров.

Командлет Invoke-Command выполняет Get-Host команду на удаленных компьютерах. Он использует нотацию точек для получения свойства Version узла PowerShell.

Эти команды выполняются по одному за раз. По завершении команд выходные данные команд со всех компьютеров сохраняются в переменной $version . Выходные данные включают имя компьютера, из которого были получены данные.

В этом примере выполняется команда на двух удаленных компьютерах. Команда Invoke-Command использует параметр AsJob , чтобы команда выполнялось в качестве фонового задания. Команды выполняются на удаленных компьютерах, но задание существует на локальном компьютере. Результаты передаются на локальный компьютер.

$s = New-PSSession -ComputerName Server01, Server02
Invoke-Command -Session $s -ScriptBlock { Get-EventLog System } -AsJob

Id   Name    State      HasMoreData   Location           Command
---  ----    -----      -----         -----------        ---------------
1    Job1    Running    True          Server01,Server02  Get-EventLog System

$j = Get-Job
$j | Format-List -Property *

HasMoreData   : True
StatusMessage :
Location      : Server01,Server02
Command       : Get-EventLog System
JobStateInfo  : Running
Finished      : System.Threading.ManualResetEvent
InstanceId    : e124bb59-8cb2-498b-a0d2-2e07d4e030ca
Id            : 1
Name          : Job1
ChildJobs     : {Job2, Job3}
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
StateChanged  :

$results = $j | Receive-Job

Командлет New-PSSession создает сеансы на удаленных компьютерах Server01 и Server02. Командлет выполняет фоновое Invoke-Command задание в каждом сеансе. Команда использует параметр AsJob для выполнения команды в качестве фонового задания. Эта команда возвращает объект задания, содержащий два дочерних объекта задания, по одному для каждого задания, выполняемого на двух удаленных компьютерах.

Команда Get-Job сохраняет объект задания в переменной $j . Затем $j переменная будет передана Format-List командлету, чтобы отобразить все свойства объекта задания в списке. Последняя команда получает результаты заданий. Он передает объект задания в $jReceive-Job командлет и сохраняет результаты в переменной $results .

В этом примере показано, как включить значения локальных переменных в команду, выполняемую на удаленном компьютере. Команда использует Using: модификатор области для идентификации локальной переменной в удаленной команде. По умолчанию предполагается, что все переменные определяются в удаленном сеансе. Модификатор области Using: появился в PowerShell 3.0. Дополнительные сведения об модификаторе Using: области см. в about_Remote_Variables и about_Scopes.

$Log = 'PowerShellCore/Operational'
Invoke-Command -ComputerName Server01 -ScriptBlock {
    Get-WinEvent -LogName $Using:Log -MaxEvents 10
}

Переменная $Log сохраняет имя журнала событий PowerShellCore или Operational. Командлет выполняется Invoke-Command на сервере Get-WinEvent Server01, чтобы получить десять последних событий из журнала событий. Значение параметра LogName — это $Log переменная, префиксная Using: модификатором области, указывающая, что она была создана в локальном сеансе, а не в удаленном сеансе.

В этом примере показан эффект использования . HideComputerName не изменяет объект, возвращаемый этим командлетом. Он изменяет только дисплей. Командлеты Format по-прежнему можно использовать для отображения свойства PsComputerName любого из затронутых объектов.

Invoke-Command -ComputerName S1, S2 -ScriptBlock { Get-Process powershell }

PSComputerName    Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id   ProcessName
--------------    -------  ------    -----      ----- -----   ------     --   -----------
S1                575      15        45100      40988   200     4.68     1392 PowerShell
S2                777      14        35100      30988   150     3.68     67   PowerShell

Invoke-Command -ComputerName S1, S2 -HideComputerName -ScriptBlock {
    Get-Process powershell
}

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id   ProcessName
-------  ------    -----      ----- -----   ------     --   -----------
575      15        45100      40988   200     4.68     1392 PowerShell
777      14        35100      30988   150     3.68     67   PowerShell

Первые две команды, используемые Invoke-Command для выполнения Get-Process команды для процесса PowerShell. Выходные данные первой команды включают свойство PsComputerName , содержащее имя компьютера, на котором выполняется команда. Выходные данные второй команды, которая использует HideComputerName, не включает столбец PsComputerName .

Ключевое param слово и параметр ArgumentList используются для передачи значений переменных именованным параметрам в блоке скрипта. В этом примере отображаются имена файлов, начинающиеся с буквы a и имеющие .pdf расширение.

Дополнительные сведения о ключевом слове param см. в about_Language_Keywords.

$parameters = @{
    ComputerName = 'Server01'
    ScriptBlock  = {
        param ($Param1, $Param2)
        Get-ChildItem -Name $Param1 -Include $Param2
    }
    ArgumentList = 'a*', '*.pdf'
}
Invoke-Command @parameters

aa.pdf
ab.pdf
ac.pdf
az.pdf

Invoke-Commandиспользует параметр ScriptBlock, определяющий Get-ChildItem использует именованные параметры, имя и включение с именами переменных. АргументList передает значения переменным.

Автоматическая $args переменная и параметр ArgumentList используются для передачи значений массива в позиции параметров в блоке скрипта. В этом примере отображается содержимое .txt каталога сервера файлов. Параметр Get-ChildItemPath имеет позицию 0, а параметр filter имеет позицию 1.

Дополнительные сведения об переменной $args см. в about_Automatic_Variables

$parameters = @{
    ComputerName = 'Server01'
    ScriptBlock  = { Get-ChildItem $args[0] $args[1] }
    ArgumentList = 'C:\Test', '*.txt*'
}
Invoke-Command @parameters

    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           6/12/2019    15:15            128 alog.txt
-a---           7/27/2019    15:16            256 blog.txt
-a---           9/28/2019    17:10             64 zlog.txt

Invoke-Command использует параметр ScriptBlock и Get-ChildItem задает $args[0] значения массива.$args[1] АргументList передает значения массива в позиции параметров для $args и Get-ChildItem.

В этом примере командлет используется Invoke-Command для запуска Sample.ps1 скрипта на всех компьютерах, перечисленных в Servers.txt файле. Команда использует параметр FilePath для указания файла скрипта. Эта команда позволяет запускать скрипт на удаленных компьютерах, даже если файл скрипта недоступен для удаленных компьютеров.

$parameters = @{
    ComputerName = (Get-Content Servers.txt)
    FilePath     = 'C:\Scripts\Sample.ps1'
    ArgumentList = 'Process', 'Service'
}
Invoke-Command @parameters

При отправке команды содержимое Sample.ps1 файла копируется в блок скрипта, а блок скрипта выполняется на каждом из удаленных компьютеров. Эта процедура эквивалентна использованию параметра ScriptBlock для отправки содержимого скрипта.

В этом примере показано, как выполнить команду на удаленном компьютере, определяемом универсальным идентификатором ресурса (URI). В этом примере выполняется Set-Mailbox команда на удаленном сервере Exchange.

$LiveCred = Get-Credential
$parameters = @{
  ConfigurationName = 'Microsoft.Exchange'
  ConnectionUri     = 'https://ps.exchangelabs.com/PowerShell'
  Credential        = $LiveCred
  Authentication    = 'Basic'
  ScriptBlock       = { Set-Mailbox Dan -DisplayName 'Dan Park' }
}
Invoke-Command @parameters

Первая строка использует Get-Credential командлет для хранения учетных данных Windows Live ID в переменной $LiveCred . PowerShell предложит пользователю ввести учетные данные Windows Live ID.

Переменная $parameters — это хэш-таблица, содержащая параметры, передаваемые командлету Invoke-Command . Командлет Invoke-Command выполняет Set-Mailbox команду с помощью конфигурации сеанса Microsoft.Exchange . Параметр ConnectionURI указывает URL-адрес конечной точки сервера Exchange. Параметр Credential указывает учетные данные, хранящиеся в переменной $LiveCred . Параметр AuthenticationMechanism указывает использование базовой проверки подлинности. Параметр ScriptBlock задает блок скрипта, содержащий команду.

В этом примере показано, как создать и использовать параметр SessionOption .

$so = New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck
$parameters = @{
    ComputerName  = 'server01'
    UseSSL        = $true
    ScriptBlock   = { Get-HotFix }
    SessionOption = $so
    Credential    = 'server01\user01'
}
Invoke-Command @parameters

Командлет New-PSSessionOption создает объект параметра сеанса, который приводит к тому, что удаленный конец не проверяет центр сертификации, каноническое имя и списки отзыва при оценке входящего подключения HTTPS. Объект SessionOption сохраняется в переменной $so .

Командлет Invoke-Command выполняет Get-HotFix команду удаленно. Параметр SessionOption присваивается переменной $so .

В этом примере показано, как использовать параметры AllowRedirection и SessionOption для управления перенаправлением URI в удаленной команде.

$max = New-PSSessionOption -MaximumRedirection 1
$parameters = @{
  ConnectionUri    = 'https://ps.exchangelabs.com/PowerShell'
  ScriptBlock      = { Get-Mailbox dan }
  AllowRedirection = $true
  SessionOption    = $max
}
Invoke-Command @parameters

Командлет New-PSSessionOption создает объект PSSessionOption , сохраненный в переменной $max . Команда использует параметр MaximumRedirection для задания свойства MaximumConnectionRedirectionCount объекта PSSessionOption равным 1.

Командлет Invoke-Command выполняет Get-Mailbox команду на удаленном сервере Microsoft Exchange Server. Параметр AllowRedirection предоставляет явное разрешение для перенаправления подключения к альтернативной конечной точке. Параметр SessionOption использует объект сеанса, хранящийся в переменной $max .

В результате, если удаленный компьютер, указанный в ConnectionURI , возвращает сообщение перенаправления, PowerShell перенаправляет подключение, но если новое назначение возвращает другое сообщение перенаправления, значение счетчика перенаправления 1 превышается и Invoke-Command возвращает ошибку без конца.

В этом примере показано, как получить доступ к сетевой папке из удаленного сеанса. Три компьютера используются для демонстрации примера. Server01 — это локальный компьютер, Server02 — это удаленный компьютер, а Net03 — это сетевой ресурс. Server01 подключается к Server02, а затем Server02 выполняет второй прыжк в Net03 для доступа к сетевой папке. Дополнительные сведения о том, как удаленное взаимодействие PowerShell поддерживает прыжки между компьютерами, см. в статье "Создание второго прыжка в удаленном взаимодействии PowerShell".

Необходимое делегирование поставщика поддержки безопасности учетных данных (CredSSP) включено в параметрах клиента на локальном компьютере и в параметрах службы на удаленном компьютере. Чтобы выполнить команды в этом примере, необходимо быть членом группы "Администраторы " на локальном компьютере и удаленном компьютере.

Enable-WSManCredSSP -Role Client -DelegateComputer Server02
$s = New-PSSession Server02
Invoke-Command -Session $s -ScriptBlock { Enable-WSManCredSSP -Role Server -Force }
$parameters = @{
  ComputerName   = 'Server02'
  ScriptBlock    = { Get-Item \\Net03\Scripts\LogFiles.ps1 }
  Authentication = 'CredSSP'
  Credential     = 'Domain01\Admin01'
}
Invoke-Command @parameters

Командлет Enable-WSManCredSSP включает делегирование CredSSP с локального компьютера Server01 на удаленный компьютер Server02. Параметр Role задает клиент для настройки параметра клиента CredSSP на локальном компьютере.

New-PSSession создает объект PSSession для Server02 и сохраняет объект в переменной$s.

Командлет Invoke-Command использует $s переменную для подключения к удаленному компьютеру Server02. Параметр ScriptBlock запускает Enable-WSManCredSSP на удаленном компьютере. Параметр роли задает сервер для настройки параметра сервера CredSSP на удаленном компьютере.

Переменная $parameters содержит значения параметров для подключения к сетевой общей папке. Командлет Invoke-Command выполняет Get-Item команду в сеансе $s. Эта команда получает скрипт из сетевого \\Net03\Scripts ресурса. Команда использует параметр authentication со значением CredSSP и параметром Credential со значением Domain01\Admin01.

В этом примере выполняется скрипт на более чем сотнях компьютеров. Чтобы свести к минимуму влияние на локальный компьютер, он подключается к каждому компьютеру, запускает скрипт, а затем отключается от каждого компьютера. Скрипт продолжает выполняться в отключенных сеансах.

$parameters = @{
  ComputerName          = (Get-Content -Path C:\Test\Servers.txt)
  InDisconnectedSession = $true
  FilePath              = '\\Scripts\Public\ConfigInventory.ps1'
  SessionOption         = @{
      OutputBufferingMode = 'Drop'
      IdleTimeout         = [timespan]::FromHours(12)
  }
}
Invoke-Command @parameters

Команда используется Invoke-Command для запуска скрипта. Значение параметра ComputerName — это Get-Content команда, которая получает имена удаленных компьютеров из текстового файла. Параметр InDisconnectedSession отключает сеансы сразу после запуска команды. Значение параметра FilePath — это скрипт, Invoke-Command который выполняется на каждом компьютере.

Значение SessionOption — это хэш-таблица. Значение OutputBufferingMode имеет значение Drop , а для значения IdleTimeout задано значение 12 часов.

Чтобы получить результаты команд и сценариев, выполняемых в отключенных сеансах, используйте Receive-PSSession командлет.

В этом примере показано, как выполнить команду на удаленном компьютере с помощью Secure Shell (SSH). Если SSH настроен на удаленном компьютере для запроса паролей, появится запрос на пароль. В противном случае необходимо использовать проверку подлинности пользователя на основе ключа SSH.

Invoke-Command -HostName UserA@LinuxServer01 -ScriptBlock { Get-MailBox * }

В этом примере показано, как выполнить команду на удаленном компьютере с помощью SSH и указать файл ключа для проверки подлинности пользователя. Вам не будет предложено ввести пароль, если проверка подлинности ключа не завершается ошибкой, и удаленный компьютер настроен для предоставления базовой проверки подлинности паролей.

$parameters = @{
    HostName    = 'UserA@LinuxServer01'
    ScriptBlock = { Get-MailBox * }
    KeyFilePath = '/UserA/UserAKey_rsa'
}
Invoke-Command

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

$sshConnections = @(
    @{
        HostName    = "WinServer1"
        UserName    = "Domain\UserA"
        KeyFilePath = "C:\Users\UserA\id_rsa"
    }
    @{
        HostName    = "UserB@LinuxServer5"
        KeyFilePath = "/Users/UserB/id_rsa"
    }
)
$results = Invoke-Command -FilePath C:\Scripts\GetInfo.ps1 -SSHConnection $sshConnections

В этом примере показано, как запустить файл скрипта на удаленном компьютере под управлением Linux с помощью параметров SSH. Параметр Options принимает хэш-список значений, передаваемых в качестве параметров базовой ssh команде, установленной подключением к удаленной системе.

$options = @{
    Port=22
    User = 'UserB'
    Host = 'LinuxServer5'
}
$results = Invoke-Command -FilePath C:\Scripts\CollectEvents.ps1 -KeyFilePath '/Users/UserB/id_rsa' -Options $options

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Вы можете передать команду в блок Invoke-Commandскрипта. Используйте $input автоматическую переменную для представления входных объектов в команде.

При использовании параметра AsJob этот командлет возвращает объект задания.

При использовании параметра InDisconnectedSession этот командлет возвращает объект PSSession.

По умолчанию этот командлет возвращает выходные данные вызываемой команды, которая является значением параметра ScriptBlock .

PowerShell включает следующие псевдонимы для Invoke-Command:

• Все платформы:
  • icm

В Windows Vista и более поздних версиях операционной системы Windows, чтобы использовать параметр ComputerName для выполнения команды на локальном компьютере, необходимо запустить PowerShell с помощью Invoke-Command".

При выполнении команд на нескольких компьютерах PowerShell подключается к компьютерам в том порядке, в котором они отображаются в списке. Однако выходные данные команды отображаются в том порядке, в котором он получил от удаленных компьютеров, которые могут отличаться.

Ошибки, которые приводятся из выполняемой команды Invoke-Command , включаются в результаты команды. Ошибки, которые будут завершающимися ошибками в локальной команде, рассматриваются как неисключающие ошибки в удаленной команде. Эта стратегия гарантирует, что завершающие ошибки на одном компьютере не закрывают команду на всех компьютерах, на которых она выполняется. Эта практика используется даже при выполнении удаленной команды на одном компьютере.

Если удаленный компьютер не находится в домене, которому доверяет локальный компьютер, компьютер может не пройти проверку подлинности учетных данных пользователя. Чтобы добавить удаленный компьютер в список доверенных узлов в WS-Management, используйте следующую команду в поставщике WSMan , где <Remote-Computer-Name> имя удаленного компьютера:

Set-Item -Path WSMan:\Localhost\Client\TrustedHosts -Value \<Remote-Computer-Name\>

При отключении PSSession с помощью параметра InDisconnectedSession состояние сеанса отключено, а доступность — None. Значение свойства состояния является относительным для текущего сеанса. Значение "Отключено " означает, что PSSession не подключен к текущему сеансу. Однако это не означает, что PSSession отключен от всех сеансов. Он может быть подключен к другому сеансу. Чтобы определить, можно ли подключиться или повторно подключиться к сеансу, используйте свойство доступности.

Значение доступности значение None указывает, что можно подключиться к сеансу. Значение "Занято " указывает, что вы не можете подключиться к PSSession , так как он подключен к другому сеансу. Дополнительные сведения о значениях свойства состояния сеансов см. в разделе RunspaceState. Дополнительные сведения о значениях свойства Availability сеансов смотрите в разделе RunspaceAvailability.

Параметры HostName и SSHConnection были включены начиная с PowerShell 6.0. Они были добавлены для предоставления удаленного взаимодействия PowerShell на основе Secure Shell (SSH). PowerShell и SSH поддерживаются на нескольких платформах (Windows, Linux, macOS) и удаленном взаимодействии PowerShell на этих платформах, где установлены и настроены SSH PowerShell. Это отдельно от предыдущего удаленного взаимодействия Windows, основанного на WinRM, и многие из конкретных функций и ограничений WinRM не применяются. Например, квоты на основе WinRM, параметры сеанса, конфигурация пользовательской конечной точки и функции отключения и повторного подключения в настоящее время не поддерживаются. Дополнительные сведения о настройке удаленного взаимодействия PowerShell SSH см. в статье о удаленном взаимодействии PowerShell по протоколу SSH.

Исполняемый ssh файл получает данные конфигурации из следующих источников в следующем порядке:

1. Параметры командной строки
2. файл конфигурации пользователя (~/.ssh/config)
3. Файл конфигурации на уровне системы (/etc/ssh/ssh_config)

Следующие параметры командлета сопоставляются с ssh параметрами и параметрами:

Все значения, явно переданные параметрами, имеют приоритет над значениями, переданными в хэш-таблицы Options . Дополнительные сведения о файлах см. в ssh_config разделе ssh_config(5).