New-PSSession
ローカル コンピューターまたはリモート コンピューターへの永続的な接続を作成します。
構文
New-PSSession
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-ConfigurationName <String>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-ThrottleLimit <Int32>]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]New-PSSession
[-Credential <PSCredential>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-ConfigurationName <String>]
[-ThrottleLimit <Int32>]
[-ConnectionUri] <Uri[]>
[-AllowRedirection]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]New-PSSession
-Credential <PSCredential>
[-Name <String[]>]
[-ConfigurationName <String>]
[-VMId] <Guid[]>
[-ThrottleLimit <Int32>]
[<CommonParameters>]New-PSSession
-Credential <PSCredential>
[-Name <String[]>]
[-ConfigurationName <String>]
-VMName <String[]>
[-ThrottleLimit <Int32>]
[<CommonParameters>]New-PSSession
[[-Session] <PSSession[]>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-ThrottleLimit <Int32>]
[<CommonParameters>]New-PSSession
[-Name <String[]>]
[-ConfigurationName <String>]
-ContainerId <String[]>
[-RunAsAdministrator]
[-ThrottleLimit <Int32>]
[<CommonParameters>]説明
New-PSSession コマンドレットは、ローカル コンピューターまたはリモート コンピューターに PowerShell セッション (PSSession) を作成します。 PSSessionを作成すると、PowerShell はリモート コンピューターへの永続的な接続を確立します。
PSSessionを使用して、関数や変数の値など、データを共有する複数のコマンドを実行します。 PSSession でコマンドを実行するには、Invoke-Command コマンドレットを使用します。 PSSession を使用してリモート コンピューターと直接対話するには、Enter-PSSession コマンドレットを使用します。 詳細については、 about_PSSessionsを参照してください。
Enter-PSSessionまたはInvoke-Commandの ComputerName パラメーターを使用して、PSSessionを作成せずにリモート コンピューターでコマンドを実行できます。 ComputerName パラメーターを使用すると、PowerShell によってコマンドに使用される一時的な接続が作成され、閉じられます。
例
例 1: ローカル コンピューターでセッションを作成する
$s = New-PSSessionこのコマンドは,ローカル・コンピューターに新しい PSSession を作成し, PSSession を $s 変数に保管します。
この PSSession を使用して、ローカル コンピューターでコマンドを実行できるようになりました。
例 2: リモート コンピューターでセッションを作成する
$Server01 = New-PSSession -ComputerName Server01このコマンドは、Server01 コンピューターに新しい PSSession を作成し、 $Server01 変数に保存します。
複数の PSSession オブジェクトを作成する場合は、有用な名前を持つ変数に割り当てます。 これは、後続のコマンドで PSSession オブジェクトを管理するのに役立ちます。
例 3: 複数のコンピューターでセッションを作成する
$s1, $s2, $s3 = New-PSSession -ComputerName Server01,Server02,Server03このコマンドは、ComputerName パラメーターで指定された各コンピューターに 1 つずつ、3 つのPSSession オブジェクトを作成します。
このコマンドでは、代入演算子 (=) を使用して、新しい PSSession オブジェクトを変数 ( $s1、 $s2、 $s3) に割り当てます。 Server01 PSSession を $s1に割り当て、Server02 PSSession を $s2に、Server03 PSSession を $s3に割り当てます。
複数のオブジェクトを一連の変数に割り当てると、PowerShell は各オブジェクトを系列内の変数にそれぞれ割り当てます。 変数よりオブジェクトが多い場合、残りのすべてのオブジェクトが最後の変数に代入されます。 オブジェクトよりも多くの変数がある場合、残りの変数は空です ($null)。
例 4: 指定したポートを使用してセッションを作成する
New-PSSession -ComputerName Server01 -Port 8081 -UseSSL -ConfigurationName E12このコマンドは、サーバー ポート 8081に接続し、SSL プロトコルを使用する Server01 コンピューターに新しいPSSessionを作成します。 新しい PSSession では、 E12と呼ばれる別のセッション構成が使用されます。
ポートを設定する前に、ポート 8081 でリッスンするように、リモートのコンピューター上で WinRM リスナーを構成する必要があります。 詳細については、 Port パラメーターの説明を参照してください。
例 5: 既存のセッションに基づいてセッションを作成する
New-PSSession -Session $s -Credential Domain01\User01このコマンドは PSSession 既存の PSSessionと同じプロパティを使用して作成します。 このコマンド形式は、既存の PSSession のリソースが使い果たされ、需要の一部をオフロードするために新しい PSSession が必要な場合に使用できます。
このコマンドでは、New-PSSession の Session パラメーターを使用して、$s変数に保存されるPSSessionを指定します。 Domain1\Admin01 ユーザーの資格情報を使用してコマンドを完了します。
例 6: 別のドメインにグローバル スコープを持つセッションを作成する
$global:s = New-PSSession -ComputerName Server1.Domain44.Corpnet.Fabrikam.com -Credential Domain01\Admin01この例では、別のドメインのコンピューターでグローバル スコープを持つ PSSession を作成する方法を示します。
既定では、コマンド ラインで作成された PSSession オブジェクトはローカル スコープで作成され、スクリプトで作成された PSSession オブジェクトにはスクリプト スコープがあります。
グローバル スコープを持つ PSSession を作成するには、新しい PSSessionを作成し グローバル スコープにキャストされる変数に PSSession を格納します。 この場合、 $s 変数はグローバル スコープにキャストされます。
このコマンドでは、 ComputerName パラメーターを使用してリモート コンピューターを指定します。 コンピューターがユーザー アカウントとは異なるドメインにあるため、コンピューターの完全な名前はユーザーの資格情報と共に指定されます。
例 7: 多くのコンピューターのセッションを作成する
$rs = Get-Content C:\Test\Servers.txt | New-PSSession -ThrottleLimit 50このコマンドは、Servers.txt ファイルにリストされている 200 台の各コンピューターにPSSessionを作成し、結果のPSSessionを$rs変数に格納します。 PSSession オブジェクトには、50のスロットル制限があります。
このコマンドの形式は、コンピューターの名前がデータベース、スプレッドシート、テキスト ファイル、またはその他のテキストに変換できる形式に格納されている場合、使用することができます。
例 8: URI を使用してセッションを作成する
$s = New-PSSession -URI http://Server01:91/NewSession -Credential Domain01\User01このコマンドは、Server01 コンピューターに PSSession を作成し、 $s 変数に格納します。 URI パラメーターを使用して、トランスポート プロトコル、リモート コンピューター、ポート、および代替セッション構成を指定します。 また、 Credential パラメーターを使用して、リモート コンピューターでセッションを作成するアクセス許可を持つユーザー アカウントを指定します。
例 9: 一連のセッションでバックグラウンド ジョブを実行する
$s = New-PSSession -ComputerName (Get-Content Servers.txt) -Credential Domain01\Admin01 -ThrottleLimit 16
Invoke-Command -Session $s -ScriptBlock {Get-Process PowerShell} -AsJobこれらのコマンドは、 PSSession オブジェクトのセットを作成し、各 PSSession オブジェクトでバックグラウンド ジョブを実行します。
最初のコマンドは、Servers.txt ファイルに一覧表示されている各コンピューターに新しい PSSession を作成します。 New-PSSession コマンドレットを使用して、PSSessionを作成します。 ComputerName パラメーターの値は、Get-Content コマンドレットを使用して、Servers.txt ファイルのコンピューター名の一覧を取得するコマンドです。
このコマンドは、 Credential パラメーターを使用して、ドメイン管理者のアクセス許可を持つ PSSession オブジェクトを作成し、 ThrottleLimit パラメーターを使用して、同時接続を 16 するようにコマンドを制限します。 このコマンドは、 PSSession オブジェクトを $s 変数に保存します。
2 番目のコマンドでは、Invoke-Command コマンドレットの AsJob パラメーターを使用して、$s の各 PSSession オブジェクトでGet-Process PowerShell コマンドを実行するバックグラウンド ジョブを開始します。
PowerShell バックグラウンド ジョブの詳細については、「 about_Jobs と about_Remote_Jobs」を参照してください。
例 10: URI を使用してコンピューターのセッションを作成する
New-PSSession -ConnectionURI https://management.exchangelabs.com/Managementこのコマンドは、コンピューター名ではなく URI で指定されたコンピューターに接続する PSSession オブジェクトを作成します。
例 11: セッション オプションを作成する
$so = New-PSSessionOption -SkipCACheck
New-PSSession -ConnectionUri https://management.exchangelabs.com/Management -SessionOption $so -Credential Server01\Admin01この例では、セッション オプション オブジェクトを作成し、 SessionOption パラメーターを使用する方法を示します。
最初のコマンドでは、 New-PSSessionOption コマンドレットを使用してセッション オプションを作成します。 結果の SessionOption オブジェクトが $so 変数に保存されます。
2 番目のコマンドは、新しいセッションでこのオプションを使用します。 このコマンドでは、 New-PSSession コマンドレットを使用して新しいセッションを作成します。 SessionOption パラメーターの値は、$so変数のSessionOption オブジェクトです。
パラメーター
-AllowRedirection
このコマンドレットによって、代替の Uniform Resource Identifier (URI) へのこの接続のリダイレクトが許可されることを示します。
ConnectionURI パラメーターを使用すると、リモート宛先は別の URI にリダイレクトする命令を返すことができます。 既定では、PowerShell は接続をリダイレクトしませんが、このパラメーターを使用して接続をリダイレクトできます。
また、 MaximumConnectionRedirectionCount セッション オプション値を変更して、接続がリダイレクトされる回数を制限することもできます。 New-PSSessionOption コマンドレットの MaximumRedirection パラメーターを使用するか、$PSSessionOptionユーザー設定変数の MaximumConnectionRedirectionCount プロパティを設定します。 既定値は 5 です。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ApplicationName
接続 URI のアプリケーション名セグメントを指定します。 コマンドで ConnectionURI パラメーターを使用しない場合は、このパラメーターを使用してアプリケーション名を指定します。
既定値は、ローカル コンピューターの $PSSessionApplicationName 基本設定変数の値です。 この基本設定変数が定義されていない場合、既定値は WSMAN。 この値はほとんどの用途に適しています。 詳細については、「 about_Preference_Variables」を参照してください。
WinRM サービスは、アプリケーション名を使用して、接続要求を処理するリスナーを選択します。 このパラメーターの値は、リモート コンピューター上のリスナーの URLPrefix プロパティの値と一致する必要があります。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Authentication
ユーザーの資格情報の認証に使用するメカニズムを指定します。 このパラメーターの有効値は、次のとおりです。
DefaultBasicCredsspDigestKerberosNegotiateNegotiateWithImplicitCredential
既定値は Default です。
このパラメーターの値の詳細については、「 AuthenticationMechanism 列挙型を参照してください。
注意事項
資格情報セキュリティ サポート プロバイダー (CredSSP) 認証は、ユーザー資格情報が認証されるリモート コンピューターに渡される認証で、リモート ネットワーク共有へのアクセスなど、複数のリソースで認証を必要とするコマンド用に設計されています。 このメカニズムを使用すると、リモート操作のセキュリティ リスクが高まります。 リモート コンピューターのセキュリティが低下している場合は、そのリモート コンピューターに渡される資格情報を使用してネットワーク セッションが制御される場合があります。
| 型: | AuthenticationMechanism |
| 指定可能な値: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CertificateThumbprint
この処理を実行するアクセス許可を持つユーザー アカウントのデジタル公開キー証明書 (X509) を指定します。 証明書の拇印を入力します。
証明書は、クライアント証明書ベースの認証で使用されます。 これらの証明書は、ローカル ユーザー アカウントにしかマップできません。ドメイン アカウントでは機能しません。
証明書を取得するには、PowerShell Cert: ドライブの Get-Item または Get-ChildItem コマンドを使用します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ComputerName
コンピューターの名前の配列を指定します。 このコマンドレットは、指定したコンピューターへの永続的な接続 (PSSession) を作成します。 複数のコンピューター名を入力 New-PSSession 、コンピューターごとに 1 つずつ、複数の PSSession オブジェクトが作成されます。 既定値はローカル コンピューターです。
1 台または複数のリモート コンピューターの NetBIOS 名、IP アドレス、または完全修飾ドメイン名を入力します。 ローカル コンピューターを指定するには、コンピューター名、 localhost、またはドット (.) を入力します。 コンピューターがユーザーとは異なるドメインにある場合は、完全修飾ドメイン名が必要です。
コンピューター名を引用符で囲んでパイプ処理して、 New-PSSessionすることもできます。
ComputerName パラメーターの値に IP アドレスを使用するには、コマンドに Credential パラメーターを含める必要があります。 また、HTTPS トランスポート用にコンピューターを構成するか、リモート コンピューターの IP アドレスをローカル コンピューター上の WinRM TrustedHosts 一覧に含める必要があります。 TrustedHosts リストにコンピューター名を追加する手順については、 about_Remote_Troubleshootingの「信頼できるホストの一覧にコンピューターを追加する方法」を参照してください。
ローカル コンピューターを ComputerName パラメーターの値に含めるには、 Run as administrator オプションを使用して Windows PowerShell を起動。
| 型: | String[] |
| Aliases: | Cn |
| 配置: | 0 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ConfigurationName
新しい PSSession に使用されるセッション構成を指定します。
セッション構成の構成名または完全修飾リソース URI を入力します。 構成名のみを指定すると、次のスキーマ URI が先頭に付加されます: http://schemas.microsoft.com/PowerShell。
セッションのセッション構成は、リモート コンピューター上にあります。 指定したセッション構成がリモート コンピューター上に存在しない場合、コマンドは失敗します。
既定値は、ローカル コンピューターの $PSSessionConfigurationName 基本設定変数の値です。 この基本設定変数が設定されていない場合、既定値は Microsoft.PowerShell です。 詳細については、「 about_Preference_Variables」を参照してください。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ConnectionUri
セッションの接続エンドポイントを定義する URI を指定します。 URI は完全修飾名にする必要があります。 この文字列の形式は次のとおりです。
<Transport>://<ComputerName>:<Port>/<ApplicationName>
既定値は、次のとおりです。
http://localhost:5985/WSMAN
ConnectionURI を指定しない場合は、UseSSL、ComputerName、Port、および ApplicationName パラメーターを使用して、ConnectionURI 値を指定できます。
URI のトランスポート セグメントの有効な値は、HTTP および HTTPS です。 トランスポート セグメントで接続 URI を指定したが、ポートを指定しない場合、セッションは標準ポート (HTTP の場合は 80 、HTTPS の場合は 443 ) で作成されます。 PowerShell リモート処理に既定のポートを使用するには、HTTP のポート 5985 または HTTPS の 5986 を指定します。
宛先コンピューターが接続を別の URI にリダイレクトする場合、コマンドで AllowRedirection パラメーターを使用しない限り、PowerShell はリダイレクトを禁止します。
| 型: | Uri[] |
| Aliases: | URI, CU |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ContainerId
コンテナーの ID の配列を指定します。 このコマンドレットは、指定された各コンテナーとの対話型セッションを開始します。 docker ps コマンドを使用して、コンテナー ID の一覧を取得します。 詳細については、 docker ps コマンドのヘルプを参照してください。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Credential
このアクションを実行するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。
User01やDomain01\User01などのユーザー名を入力するか、Get-Credential コマンドレットによって生成されたPSCredential オブジェクトを入力します。 ユーザー名を入力すると、パスワードの入力を求められます。
資格情報は PSCredential オブジェクトに格納され、パスワードは SecureString として格納されます。
Note
SecureString データ保護の詳細については、「 SecureString のセキュリティ保護方法」を 参照してください。
| 型: | PSCredential |
| 配置: | Named |
| 規定値: | Current user |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-EnableNetworkAccess
このコマンドレットが、ループバック セッションに対話型セキュリティ トークンを追加することを示します。 対話型トークンを使用すると、他のコンピューターからデータを取得するコマンドをループバック セッションで実行できます。 たとえば、リモート コンピューターからローカル コンピューターに XML ファイルをコピーするコマンドをセッションで実行できます。
ループバック セッションは、同じコンピューターで開始および終了する PSSession です。 ループバック セッションを作成するには、 ComputerName パラメーターを省略するか、値をドット (.)、 localhost、またはローカル コンピューターの名前に設定します。
既定では、このコマンドレットはネットワーク トークンを使用してループバック セッションを作成します。これにより、リモート コンピューターに対して認証するための十分なアクセス許可が提供されない可能性があります。
EnableNetworkAccess パラメーターは、ループバック セッションでのみ有効です。 リモート コンピューターでセッションを作成するときに EnableNetworkAccess を使用すると、コマンドは成功しますが、パラメーターは無視されます。
セッション資格情報を他のコンピューターに委任する Authentication パラメーターのCredSSP値を使用して、ループバック セッションでリモート アクセスを有効にすることもできます。
コンピューターを悪意のあるアクセスから保護するために、対話型トークンを持つ切断されたループバック セッション ( EnableNetworkAccess パラメーターを使用して作成されたもの) は、セッションが作成されたコンピューターからのみ再接続できます。 CredSSP 認証を使用するセッションが切断された場合には、他のコンピューターから再接続することができます。 詳細については、Disconnect-PSSessionを参照してください。
このパラメーターは PowerShell 3.0 で導入されました。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
PSSessionのフレンドリ名を指定します。
Get-PSSessionやEnter-PSSessionなどの他のコマンドレットを使用する場合は名前を使用して PSSession を参照できます。 名前は、コンピューターや現在のセッションで一意である必要ありません。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Port
この接続に使用するリモート コンピューター上のネットワーク ポートを指定します。 リモート コンピューターに接続するには、リモート コンピューターで、接続に使用されるポートをリッスンすることが必要です。 既定のポートは 5985(HTTP の WinRM ポート)、 5986 (HTTPS の WinRM ポート) です。
別のポートを使用する前に、そのポートでリッスンするようにリモート コンピューター上の WinRM リスナーを構成する必要があります。 リスナーを構成するには、次のコマンドを使用します。
winrm delete winrm/config/listener?Address=*+Transport=HTTPwinrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}
必要な場合を除き、 Port パラメーターは使用しないでください。 コマンドのポート設定は、コマンドが実行されるすべてのコンピューターまたはセッションに適用されます。 代替ポートの設定によっては、コマンドがすべてのコンピューターで実行されない場合があります。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsAdministrator
PSSessionが管理者として実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Session
このコマンドレットが新しい PSSession のモデルとして使用するPSSession オブジェクトの配列を指定します。 このパラメーターは、指定した PSSession オブジェクトと同じプロパティを持つ新しい PSSession オブジェクトを作成します。
PSSession オブジェクトを含む変数、またはPSSessionオブジェクトを作成または取得するコマンド (New-PSSession、Get-PSSession コマンドなど) を入力します。
結果として得られる PSSession オブジェクトのコンピューター名、アプリケーション名、接続 URI、ポート、構成名、スロットル制限、Secure Sockets Layer (SSL) の値は元のオブジェクトと同じですが、表示名、ID、インスタンス ID (GUID) は異なります。
| 型: | PSSession[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-SessionOption
セッションの詳細オプションを指定します。 SessionOptionオブジェクト (New-PSSessionOption コマンドレットを使用して作成するオブジェクトなど) を入力するか、キーがセッション オプション名で値がセッション オプション値であるハッシュ テーブルを入力します。
オプションの既定値は、 $PSSessionOption 設定変数の値 (設定されている場合) によって決まります。 それ以外の場合、既定値はセッション構成で設定されたオプションによって決まります。
セッション オプションの値は、 $PSSessionOption 基本設定変数およびセッション構成で設定されたセッションの既定値よりも優先されます。 ただし、セッション構成で設定された最大値、クォータ、または制限よりも優先されることはありません。
デフォルト値を含むセッション・オプションの説明については、 New-PSSessionOptionを参照してください。 $PSSessionOption基本設定変数の詳細については、about_Preference_Variablesを参照してください。 セッション構成の詳細については、「 about_Session_Configurations」を参照してください。
| 型: | PSSessionOption |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ThrottleLimit
このコマンドを実行するために確立できる最大コンカレント接続数を指定します。
このパラメーターを省略するか、 0 (ゼロ) の値を入力すると、既定値の 32 が使用されます。
スロットル制限は現在のコマンドのみに適用され、セッションまたはコンピューターには適用されません。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UseSSL
このコマンドレットが SSL プロトコルを使用してリモート コンピューターへの接続を確立することを示します。 既定では、SSL は使用されません。
WS-Management は、ネットワーク経由で送信されるすべての PowerShell コンテンツを暗号化します。 UseSSL パラメーターは、HTTP 接続ではなく HTTPS 接続を介してデータを送信する追加の保護を提供します。
このパラメーターを使用しても、コマンドに使用されているポートで SSL を使用できない場合、コマンドは失敗します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMId
仮想マシン ID の配列を指定します。 このコマンドレットは、指定された各仮想マシンとの PowerShell Direct 対話型セッションを開始します。 詳細については、「 PowerShell を使用した仮想マシンの自動化と管理を参照してください。
Get-VMを使用して、Hyper-V ホストで使用可能な仮想マシンを確認します。
| 型: | Guid[] |
| Aliases: | VMGuid |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMName
仮想マシンの名前の配列を指定します。 このコマンドレットは、指定された各仮想マシンとの PowerShell Direct 対話型セッションを開始します。 詳細については、「 PowerShell を使用した仮想マシンの自動化と管理を参照してください。
Get-VMを使用して、Hyper-V ホストで使用可能な仮想マシンを確認します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
入力
このコマンドレットに文字列をパイプできます。
System.URI
このコマンドレットに URI をパイプできます。
セッション オブジェクトをこのコマンドレットにパイプできます。
出力
メモ
Windows PowerShell には、 New-PSSessionの次のエイリアスが含まれています。
nsnこのコマンドレットでは、PowerShell リモート処理インフラストラクチャを使用します。 このコマンドレットを使用するには、ローカル コンピューターとリモート コンピューターを PowerShell リモート処理用に構成する必要があります。 詳細については、「about_Remote_Requirements」を参照してください。
ローカル コンピューターで PSSession を作成するには、 管理者として実行 オプションを使用して PowerShell を起動します。
PSSession を終了したら、
Remove-PSSessionコマンドレットを使用してPSSession を削除しそのリソースを解放します。
関連リンク
PowerShell