PowerShell には、リモート コンピューターに対してコマンドを実行する方法がいくつか用意されています。 最後の章では、CIM コマンドレットを使用して WMI にリモートでクエリを実行する方法について説明しました。 PowerShell には、組み込みの ComputerName パラメーターを備えるいくつかのコマンドレットも含まれています。
次の例に示すように、Get-Command パラメーターでを使用して、ComputerName パラメーターを含むコマンドレットを識別できます。
Get-Command -ParameterName ComputerName
CommandType Name Version Source
----------- ---- ------- ------
Cmdlet Add-Computer 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Clear-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Connect-PSSession 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Enter-PSSession 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Get-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Get-HotFix 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Get-Process 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Get-PSSession 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Get-Service 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Get-WmiObject 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Invoke-Command 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Invoke-WmiMethod 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Limit-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet New-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet New-PSSession 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Receive-Job 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Receive-PSSession 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Register-WmiEvent 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Remove-Computer 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Remove-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Remove-PSSession 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Remove-WmiObject 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Rename-Computer 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Restart-Computer 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Send-MailMessage 3.1.0.0 Microsoft.PowerShell.Utility
Cmdlet Set-Service 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Set-WmiInstance 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Show-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Stop-Computer 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Test-Connection 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Write-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Get-ProcessやGet-HotFixなどのコマンドには ComputerName パラメーターが含まれていますが、この方法は、リモート システムに対してコマンドを実行するために Microsoft が推奨する長期的な方向ではありません。
ComputerName パラメーターを持つコマンドが見つかると、多くの場合、Credential パラメーターがないため、代替資格情報を指定することが困難になります。 管理者特権セッションから PowerShell を実行しても成功は保証されません。ネットワーク ファイアウォールによって、システムとリモート コンピューター間の要求がブロックされる可能性があります。
この章で示す PowerShell リモート処理コマンドを使用するには、リモート コンピューターで PowerShell リモート処理を有効にする必要があります。 これを有効にするには、 Enable-PSRemoting コマンドレットを実行します。
Enable-PSRemoting
WinRM has been updated to receive requests.
WinRM service type changed successfully.
WinRM service started.
WinRM has been updated for remote management.
WinRM firewall exception enabled.
1 対 1 のリモート通信
対話型リモート セッションが必要な場合は、1 対 1 のリモート処理が必要です。 この種類のリモート処理は、 Enter-PSSession コマンドレットを使用して提供されます。
ドメイン管理者の資格情報を $Cred 変数に格納します。 この方法では、現在の PowerShell セッションがアクティブなままである限り、資格情報を 1 回入力し、コマンドごとに再利用できます。
$Cred = Get-Credential
dc01 という名前のドメイン コントローラーへの 1 対 1 の PowerShell リモート処理セッションを確立します。
Enter-PSSession -ComputerName dc01 -Credential $Cred
PowerShell プロンプトの前に [dc01] があることに注意してください。 このプレフィックスは、dc01 という名前のリモート コンピューターとの対話型セッション中であることを示します。 実行するコマンドは、ローカル コンピューターではなく dc01 で実行されるようになりました。
[dc01]: PS C:\Users\Administrator\Documents>
リモート コンピューターにインストールされている PowerShell コマンドとモジュールにのみアクセスできることに注意してください。 他のモジュールをローカルにインストールした場合、リモート セッションでは使用できません。
1 対 1 の対話型リモート処理セッションを介して接続すると、リモート コンピューターに直接座っているかのように表示されます。
[dc01]: Get-Process | Get-Member
TypeName: System.Diagnostics.Process
Name MemberType Definition
---- ---------- ----------
Handles AliasProperty Handles = Handlecount
Name AliasProperty Name = ProcessName
NPM AliasProperty NPM = NonpagedSystemMemorySize64
PM AliasProperty PM = PagedMemorySize64
SI AliasProperty SI = SessionId
VM AliasProperty VM = VirtualMemorySize64
WS AliasProperty WS = WorkingSet64
Disposed Event System.EventHandler Disposed(Sy...
ErrorDataReceived Event System.Diagnostics.DataReceived...
Exited Event System.EventHandler Exited(Syst...
OutputDataReceived Event System.Diagnostics.DataReceived...
BeginErrorReadLine Method void BeginErrorReadLine()
BeginOutputReadLine Method void BeginOutputReadLine()
CancelErrorRead Method void CancelErrorRead()
CancelOutputRead Method void CancelOutputRead()
Close Method void Close()
CloseMainWindow Method bool CloseMainWindow()
CreateObjRef Method System.Runtime.Remoting.ObjRef ...
Dispose Method void Dispose(), void IDisposabl...
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetLifetimeService Method System.Object GetLifetimeService()
GetType Method type GetType()
InitializeLifetimeService Method System.Object InitializeLifetim...
Kill Method void Kill()
Refresh Method void Refresh()
Start Method bool Start()
ToString Method string ToString()
WaitForExit Method bool WaitForExit(int millisecon...
WaitForInputIdle Method bool WaitForInputIdle(int milli...
__NounName NoteProperty string __NounName=Process
BasePriority Property int BasePriority {get;}
Container Property System.ComponentModel.IContaine...
EnableRaisingEvents Property bool EnableRaisingEvents {get;s...
ExitCode Property int ExitCode {get;}
ExitTime Property datetime ExitTime {get;}
Handle Property System.IntPtr Handle {get;}
HandleCount Property int HandleCount {get;}
HasExited Property bool HasExited {get;}
Id Property int Id {get;}
MachineName Property string MachineName {get;}
MainModule Property System.Diagnostics.ProcessModul...
MainWindowHandle Property System.IntPtr MainWindowHandle ...
MainWindowTitle Property string MainWindowTitle {get;}
MaxWorkingSet Property System.IntPtr MaxWorkingSet {ge...
MinWorkingSet Property System.IntPtr MinWorkingSet {ge...
Modules Property System.Diagnostics.ProcessModul...
NonpagedSystemMemorySize Property int NonpagedSystemMemorySize {g...
NonpagedSystemMemorySize64 Property long NonpagedSystemMemorySize64...
PagedMemorySize Property int PagedMemorySize {get;}
PagedMemorySize64 Property long PagedMemorySize64 {get;}
PagedSystemMemorySize Property int PagedSystemMemorySize {get;}
PagedSystemMemorySize64 Property long PagedSystemMemorySize64 {g...
PeakPagedMemorySize Property int PeakPagedMemorySize {get;}
PeakPagedMemorySize64 Property long PeakPagedMemorySize64 {get;}
PeakVirtualMemorySize Property int PeakVirtualMemorySize {get;}
PeakVirtualMemorySize64 Property long PeakVirtualMemorySize64 {g...
PeakWorkingSet Property int PeakWorkingSet {get;}
PeakWorkingSet64 Property long PeakWorkingSet64 {get;}
PriorityBoostEnabled Property bool PriorityBoostEnabled {get;...
PriorityClass Property System.Diagnostics.ProcessPrior...
PrivateMemorySize Property int PrivateMemorySize {get;}
PrivateMemorySize64 Property long PrivateMemorySize64 {get;}
PrivilegedProcessorTime Property timespan PrivilegedProcessorTim...
ProcessName Property string ProcessName {get;}
ProcessorAffinity Property System.IntPtr ProcessorAffinity...
Responding Property bool Responding {get;}
SafeHandle Property Microsoft.Win32.SafeHandles.Saf...
SessionId Property int SessionId {get;}
Site Property System.ComponentModel.ISite Sit...
StandardError Property System.IO.StreamReader Standard...
StandardInput Property System.IO.StreamWriter Standard...
StandardOutput Property System.IO.StreamReader Standard...
StartInfo Property System.Diagnostics.ProcessStart...
StartTime Property datetime StartTime {get;}
SynchronizingObject Property System.ComponentModel.ISynchron...
Threads Property System.Diagnostics.ProcessThrea...
TotalProcessorTime Property timespan TotalProcessorTime {get;}
UserProcessorTime Property timespan UserProcessorTime {get;}
VirtualMemorySize Property int VirtualMemorySize {get;}
VirtualMemorySize64 Property long VirtualMemorySize64 {get;}
WorkingSet Property int WorkingSet {get;}
WorkingSet64 Property long WorkingSet64 {get;}
PSConfiguration PropertySet PSConfiguration {Name, Id, Prio...
PSResources PropertySet PSResources {Name, Id, Handleco...
Company ScriptProperty System.Object Company {get=$thi...
CPU ScriptProperty System.Object CPU {get=$this.To...
Description ScriptProperty System.Object Description {get=...
FileVersion ScriptProperty System.Object FileVersion {get=...
Path ScriptProperty System.Object Path {get=$this.M...
Product ScriptProperty System.Object Product {get=$thi...
ProductVersion ScriptProperty System.Object ProductVersion {g...
リモート コンピューターの操作が完了したら、 Exit-PSSession コマンドレットを実行してリモート セッションを終了します。
[dc01]: Exit-PSSession
一対多リモート処理
リモート コンピューターでタスクを対話形式で実行する必要がある場合がありますが、複数のリモート システムでコマンドを同時に実行すると、PowerShell リモート処理がより強力になります。
Invoke-Command コマンドレットを使用して、1 つ以上のリモート コンピューターで同時にコマンドを実行します。
次の例では、3 台のサーバーに対して Windows タイム サービスの状態を照会します。
Get-Service コマンドレットは、Invoke-Commandのスクリプト ブロック内に配置されます。つまり、各リモート コンピューターで実行されます。
Invoke-Command -ComputerName dc01, sql02, web01 {
Get-Service -Name W32time
} -Credential $Cred
結果は、逆シリアル化されたオブジェクトとしてローカル セッションに返されます。
Status Name DisplayName PSComputerName
------ ---- ----------- --------------
Running W32time Windows Time web01
Start... W32time Windows Time dc01
Running W32time Windows Time sql02
返されたオブジェクトがデシリアライズされていることを確認するには、出力を Get-Member にパイプします。
Invoke-Command -ComputerName dc01, sql02, web01 {
Get-Service -Name W32time
} -Credential $Cred | Get-Member
TypeName: Deserialized.System.ServiceProcess.ServiceController
Name MemberType Definition
---- ---------- ----------
GetType Method type GetType()
ToString Method string ToString(), string ToString(strin...
Name NoteProperty string Name=W32time
PSComputerName NoteProperty string PSComputerName=dc01
PSShowComputerName NoteProperty bool PSShowComputerName=True
RequiredServices NoteProperty Deserialized.System.ServiceProcess.Servi...
RunspaceId NoteProperty guid RunspaceId=5ed06925-8037-43ef-9072-...
CanPauseAndContinue Property System.Boolean {get;set;}
CanShutdown Property System.Boolean {get;set;}
CanStop Property System.Boolean {get;set;}
Container Property {get;set;}
DependentServices Property Deserialized.System.ServiceProcess.Servi...
DisplayName Property System.String {get;set;}
MachineName Property System.String {get;set;}
ServiceHandle Property System.String {get;set;}
ServiceName Property System.String {get;set;}
ServicesDependedOn Property Deserialized.System.ServiceProcess.Servi...
ServiceType Property System.String {get;set;}
Site Property {get;set;}
StartType Property System.String {get;set;}
Status Property System.String {get;set;}
ほとんどのメソッドが逆シリアル化されたオブジェクトに見つからないことに注意してください。 これらのオブジェクトがライブでないため、メソッドがありません。 リモート コンピューターに対してコマンドを実行すると、オブジェクトの状態の不活性なスナップショットになります。 たとえば、逆シリアル化されたオブジェクトを使用してサービスを開始または停止することはできません。これは、必要なメソッドにアクセスできないためです。
ただし、これは、Stop()でInvoke-Commandのようなメソッドを使用できないという意味ではありません。 キーは、リモート セッション内でメソッドを呼び出す必要があるということです。
デモンストレーションするには、 Stop() メソッドをリモートで呼び出して、3 つのリモート サーバーすべてで Windows タイム サービスを停止します。
Invoke-Command -ComputerName dc01, sql02, web01 {
(Get-Service -Name W32time).Stop()
} -Credential $Cred
Invoke-Command -ComputerName dc01, sql02, web01 {
Get-Service -Name W32time
} -Credential $Cred
Status Name DisplayName PSComputerName
------ ---- ----------- --------------
Stopped W32time Windows Time web01
Stopped W32time Windows Time dc01
Stopped W32time Windows Time sql02
前の章で説明したように、タスクを実行するために使用できるコマンドレットがある場合は、メソッドを直接呼び出すのではなく、それを使用することをお勧めします。 たとえば、サービスを停止するには、Stop-Service メソッドの代わりに Stop() コマンドレットを使用します。
前の例では、 Stop() メソッドを使用してポイントを作成しています。 一部のユーザーは、PowerShell リモート処理でメソッドを使用できないと誤って考えています。 ローカル セッションに返された逆シリアル化されたオブジェクトに対してメソッドを呼び出すことはできませんが、リモート セッション内で呼び出すことができます。
PowerShell セッション
前のセクションの最後の例では、 Invoke-Command コマンドレットを使用して 2 つのコマンドを実行しました。 このシナリオでは、2 つの個別のセッションが確立され、取り壊されました。 コマンドごとに 1 つ。
CIM セッションと同様に、永続的な PowerShell セッションを使用すると、コマンドごとに新しいセッションを作成するオーバーヘッドなしで、リモート コンピューターに対して複数のコマンドを実行できます。
この章、DC01、SQL02、および WEB01 で使用している 3 台の各コンピューターへの PowerShell セッションを作成します。
$Session = New-PSSession -ComputerName dc01, sql02, web01 -Credential $Cred
次に、 $Session 変数を使用して、そのメソッドを呼び出して Windows タイム サービスを開始し、サービスの状態を確認します。
Invoke-Command -Session $Session {(Get-Service -Name W32time).Start()}
Invoke-Command -Session $Session {Get-Service -Name W32time}
Status Name DisplayName PSComputerName
------ ---- ----------- --------------
Running W32time Windows Time web01
Start... W32time Windows Time dc01
Running W32time Windows Time sql02
別の資格情報を使用してセッションを作成したら、コマンドごとにこれらの資格情報を再度指定する必要はありません。
セッションの使用が完了したら、必ずセッションを削除してください。
Get-PSSession | Remove-PSSession
概要
この章では、1 台のリモート コンピューターでコマンドを対話形式で実行したり、一対多リモート処理を使用して複数のシステム間でコマンドを実行したりするなど、PowerShell リモート処理の基礎について学習しました。 また、同じリモート コンピューターに対して複数のコマンドを実行するときに、永続的な PowerShell セッションを使用する利点についても説明しました。
レビュー
- PowerShell リモーティングを有効にする方法
- リモート コンピューターとの対話型セッションを開始するには、どのような PowerShell コマンドを使用しますか?
- 各コマンドでコンピューター名を指定する代わりに PowerShell リモート処理セッションを使用する利点の 1 つは何ですか?
- 1 対 1 の対話型リモート処理シナリオで PowerShell セッションを使用できますか?
- コマンドレットによって返されるオブジェクトがローカルで実行され、同じコマンドレットが
Invoke-Commandを使用してリモート コンピューターで実行されたときに返されるオブジェクトの違いは何ですか?
リファレンス
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
PowerShell