Invoke-Command

Invoke-Command [-ScriptBlock] <scriptblock> [[-ComputerName] <string[]>] [-ApplicationName <string>] [-AsJob] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-CertificateThumbprint <string>] [-ConfigurationName <string>] [-Credential <PSCredential>] [-HideComputerName] [-JobName <string>] [-Port <int>] [-SessionOption <PSSessionOption>] [-ThrottleLimit <int>] [-UseSSL] [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

Invoke-Command [-FilePath] <string> [[-ComputerName] <string[]>] [-ApplicationName <string>] [-AsJob] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-ConfigurationName <string>] [-Credential <PSCredential>] [-HideComputerName] [-JobName <string>] [-Port <int>] [-SessionOption <PSSessionOption>] [-ThrottleLimit <int>] [-UseSSL] [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

Invoke-Command [-FilePath] <string> [[-Session] <PSSession[]>] [-AsJob] [-HideComputerName] [-JobName <string>] [-ThrottleLimit <int>] [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

Invoke-Command [-FilePath] <string> [[-ConnectionURI] <Uri[]>] [-AllowRedirection] [-AsJob] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-ConfigurationName <string>] [-Credential <PSCredential>] [-HideComputerName] [-JobName <string>] [-SessionOption <PSSessionOption>] [-ThrottleLimit <int>] [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

Invoke-Command [-ScriptBlock] <scriptblock> [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

Invoke-Command [-ScriptBlock] <scriptblock> [[-Session] <PSSession[]>] [-AsJob] [-HideComputerName] [-JobName <string>] [-ThrottleLimit <int>] [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

Invoke-Command [-ScriptBlock] <scriptblock> [[-ConnectionURI] <Uri[]>] [-AllowRedirection] [-AsJob] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-CertificateThumbprint <string>] [-ConfigurationName <string>] [-Credential <PSCredential>] [-HideComputerName] [-JobName <string>] [-SessionOption <PSSessionOption>] [-ThrottleLimit <int>] [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

C:\PS>invoke-command -filepath c:\scripts\test.ps1 -computerName Server01

Disks: C:, D:, E:
Status: Warning, Normal, Normal

Описание
-----------
Эта команда выполняет скрипт Test.ps1 на компьютере Server01. 

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

C:\PS>invoke-command -computername server01 -credential domain01\user01 -scriptblock {get-culture}

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

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

Windows PowerShell отображает диалоговое окно, в котором необходимо указать пароль и метод проверки подлинности для учетной записи User01. Затем команда выполняется на компьютере Server01 и возвращает результаты.

C:\PS>$s = new-pssession -computername server02 -credential domain01\user01

C:\PS> invoke-command -session $s -scriptblock {get-culture}

Описание
-----------
В этом примере та же команда "Get-Culture" выполняется в сеансе (постоянное подключение) на удаленном компьютере Server02. Обычно сеанс создается только при выполнении на удаленном компьютере последовательности команд.

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

Вторая команда выполняет команду Get-Culture на компьютере Server02 с помощью командлета Invoke-Command. Параметр Session используется для задания сеанса, сохраненного в переменной $s. 

Windows PowerShell выполняет команду в рамках сеанса на компьютере Server02.

C:\PS>invoke-command -computername Server02 -scriptblock {$p = get-process powershell}

C:\PS> invoke-command -computername Server02 -scriptblock {$p.virtualmemorysize}
C:\PS>

C:\PS> $s = new-pssession -computername Server02
C:\PS> invoke-command -session $s -scriptblock {$p = get-process powershell}
C:\PS> invoke-command -session $s -scriptblock {$p.virtualmemorysize}
17930240

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

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

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

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

Третья команда использует командлет New-PSSession для создания сеанса на компьютере Server02. После этого она сохраняет сеанс в переменной $s. Четвертая и пятая команды повторяют последовательность команд, выполнявшуюся раньше, но в данном случае используется параметр Session команды Invoke-Command для выполнения обеих команд в рамках одного сеанса. 

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

C:\PS>$command = { get-eventlog -log "windows powershell" | where {$_.message -like "*certificate*"} }

C:\PS> invoke-command -computername S1, S2 -scriptblock $command

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

Если вся команда сохранена в локальной переменной, можно указать переменную в качестве значения параметра ScriptBlock. Для отправки значения локальной переменной не требуется использовать ключевое слово "param" или переменную ArgumentList.

Первая команда сохраняет команду Get-Eventlog в переменной $command. Формат команды соответствует формату блока скрипта.

Вторая команда использует командлет Invoke-Command для выполнения команды, содержащейся в переменной $command, на удаленных компьютерах S1 и S2.

C:\PS>invoke-command -computername server01, server02, TST-0143, localhost -configurationname MySession.PowerShell -scriptblock {get-eventlog "windows powershell"}

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

Параметр ComputerName используется в команде для указания компьютеров. Имена компьютеров представлены в формате списка, разделенного запятыми. В список компьютеров входит значение "localhost", представляющее локальный компьютер.

Команда используется параметр ConfigurationName для указания альтернативной конфигурации сеанса Windows PowerShell и параметр ScriptBlock для указания команды.

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

C:\PS>$version = invoke-command -computername (get-content machines.txt) -scriptblock {(get-host).version}

Описание
-----------
Эта команда получает версию основного приложения Windows PowerShell, запущенного на 200 удаленных компьютерах. 

Поскольку выполняется только одна команда, не требуется создавать постоянные подключения (сеансы) ко всем компьютерам. Вместо этого для указания компьютеров в команде используется параметр ComputerName.

Команда использует командлет Invoke-Command для выполнения команды Get-Host. Для получения значения свойства Version основного приложения Windows PowerShell используется обращение через точку.

Для указания компьютеров используется командлет Get-Content, который получает содержимое файла с именами компьютеров Machine.txt.

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

C:\PS>$s = new-pssession -computername Server01, Server02

C:\PS> invoke-command -session $s -scriptblock {get-eventlog system} -AsJob

Id   Name    State      HasMoreData   Location           Command
---  ----    -----      -----         -----------        --------             -------
1    Job1    Running    True          Server01,Server02  get-eventlog system


C:\PS> $j = Get-Job

C:\PS> $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  :

C:\PS> $results = $j | Receive-Job

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

Первая команда использует командлет New-PSSession для создания сеансов на удаленных компьютерах Server01 и Server02.

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

Третья команда использует команду Get-Job для сохранения объекта задания в переменной $j. 

Четвертая команда использует оператор конвейера (|) для отправки значения переменной $j командлету Format-List, который выводит все свойства объекта задания в виде списка.

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

C:\PS>$MWFO-LOg = Microsoft-Windows-Forwarding/Operational

C:\PS> invoke-command -computername server01 -scriptblock {param($log, $num) get-eventlog -logname $log -newest $num} -ArgumentList $MWFO-log, 10

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

Первая команда сохраняет имя журнала событий Microsoft-Windows-Forwarding/Operational в переменной $MWFO-Log.

Вторая команда использует командлет Invoke-Command для выполнения команды Get-EventLog на удаленном компьютере Server01. Эта команда получает 10 самых последних событий из журнала событий Microsoft-Windows-Forwarding/Operational на компьютере Server01.

В этой команде ключевое слово "param" используется для создания двух переменных, $log и $num, которые служат в качестве заполнителей для команды Get-EventLog. Произвольные имена этих заполнителей могут не соответствовать именам локальных переменных, используемых для установки значений заполнителей.

Значения параметра ArgumentList демонстрируют два различных способа указания значений в списке аргументов. Значение заполнителя $log — значение переменной $MFWO-Log, которое определяется в первой команде. Значение переменной $num равняется 10.

Перед отправкой команды на удаленный компьютер переменные заменяются заданными значениями.

C:\PS>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


C:\PS> invoke-command -computername S1, S2 -scriptblock {get-process powershell} -HideComputerName

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

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

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

Использования параметра HideComputerName не приводит к изменению объекта. Можно по-прежнему использовать командлеты Format для отображения свойства PsComputerName любого соответствующего объекта.

C:\PS>invoke-command -comp (get-content servers.txt) -filepath c:\scripts\sample.ps1 -argumentlist Process, Service

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

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

C:\PS>$LiveCred = Get-Credential

C:\PS> Invoke-Command -ConfigurationName Microsoft.Exchange `
         -ConnectionUri https://ps.exchangelabs.com/powershell `
         -Credential $LiveCred  -Authentication Basic `
         -scriptblock {Invoke-Command {Set-Mailbox dan -DisplayName "Dan Park"}

Описание
-----------
В этом примере показано, как выполнять команду на удаленном компьютере, указанном с помощью URI (интернет-адреса). В этом конкретном примере на удаленном сервере Exchange Server выполняется команда Set-Mailbox. Открывающая кавычка (`) в команде Windows PowerShell является знаком продолжения строки.

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

Вторая команда использует командлет Invoke-Command для выполнения команды Set-Mailbox. Параметр ConfigurationName используется командой для указания, что команда должна выполняться в рамках сеанса, конфигурация которого соответствует конфигурации сеанса Microsoft Exchange. Параметр ConnectionURI указывает URL-адрес конечной точки сервера Exchange Server. 

Параметр Credential указывает учетные данные Windows Live, сохраненные в переменной $LiveCred. Параметр AuthenticationMechanism указывает на использование обычной проверки подлинности. Параметр ScriptBlock задает блок скрипта, в котором содержится команда.

C:\PS>$max = New-PSSessionOption -MaximumRedirection 1

C:\PS> Invoke-Command -ConnectionUri https://ps.exchangelabs.com/powershell `
         -scriptblock {Invoke-Command {Get-Mailbox dan} `
         -AllowRedirection -SessionOption $max

Описание
-----------
Эта команда показывает, как использовать параметры AllowRedirection и SessionOption для управления перенаправлением URI в удаленную команду.

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

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

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

C:\PS>$so = New-PSSessionOption -SkipCACheck

PS C:\> invoke-command $s { get-hotfix } -SessionOption $so -credential server01\user01

Описание
-----------
В этом примере демонстрируется создание и использование параметра SessionOption. 

Первая команда создает параметр сеанса с помощью командлета New-PSSessionOption. Результирующий объект SessionOption сохраняется в параметре $so.

Вторая команда выполняет команду Get-Hotfix на удаленном компьютере с помощью командлета Invoke-Command. Значением параметра SessionOption является объект SessionOption, сохраненный в переменной $so.

C:\PS>enable-wsmanCredSSP -delegate server02

C:\PS> connect-wsman Server02

C:\PS> set-item wsman:\server02*\service\auth\credSSP -value $true

C:\PS> $s = new-pssession server02

C:\PS> invoke-command -session $s -script {get-item \\Net03\Scripts\LogFiles.ps1} -authentication credssp -credential domain01\admin01

Описание
-----------
В этом примере показано, как получить доступ к общему сетевому ресурсу из удаленного сеанса. 

Для выполнения команды необходимо включить делегирование CredSSP в параметрах клиента на локальном компьютере и в параметрах службы на удаленном компьютере. Для выполнения команд в этом примере текущий пользователь должен быть членом группы "Администраторы" на локальном и удаленном компьютере.

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

Вторая команда использует командлет Connect-WSman для подключения к компьютеру Server02. Это действие добавляет узел для компьютера Server02 на диск WSMan: на локальном компьютере, позволяя просматривать и изменять параметры WS-Management на компьютере Server02.

Третья команда использует командлет Set-Item для изменения значения элемента CredSSP в узле службы компьютера Server02 на значение "True". Это позволяет включить CredSSP в параметрах службы на удаленном компьютере.

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

Пятая команда использует командлет Invoke-Command для выполнения команды Get-Item в сеансе в $s, которая возвращает скрипт из общего сетевого ресурса Net03\Scripts. Команда использует параметр Credential и параметр Authentication со значением CredSSP.