Get-PSSession
ローカル コンピューターとリモート コンピューター上の PowerShell セッションを取得します。
構文
Get-PSSession
[-Name <String[]>]
[<CommonParameters>]
Get-PSSession
[-ComputerName] <String[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
Get-PSSession
[-ComputerName] <String[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
Get-PSSession
[-ConnectionUri] <Uri[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
Get-PSSession
[-ConnectionUri] <Uri[]>
[-ConfigurationName <String>]
[-AllowRedirection]
-InstanceId <Guid[]>
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
Get-PSSession
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-State <SessionFilterState>]
-VMName <String[]>
[<CommonParameters>]
Get-PSSession
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
-ContainerId <String[]>
[<CommonParameters>]
Get-PSSession
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-State <SessionFilterState>]
-ContainerId <String[]>
[<CommonParameters>]
Get-PSSession
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
-VMId <Guid[]>
[<CommonParameters>]
Get-PSSession
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-State <SessionFilterState>]
-VMId <Guid[]>
[<CommonParameters>]
Get-PSSession
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
-VMName <String[]>
[<CommonParameters>]
Get-PSSession
[-InstanceId <Guid[]>]
[<CommonParameters>]
Get-PSSession
[-Id] <Int32[]>
[<CommonParameters>]
説明
コマンドレットは Get-PSSession
、ローカル コンピューターとリモート コンピューター上のユーザーが管理する PowerShell セッション (PSSessions) を取得します。
Windows PowerShell 3.0 以降では、セッションは各接続のリモート側のコンピューターに格納されます。 ComputerName パラメーターまたは ConnectionUri パラメーターGet-PSSession
を使用すると、現在のセッションで作成されていない場合でも、ローカル コンピューターまたはリモート コンピューターに接続するセッションを取得できます。
パラメーターがない場合は、 Get-PSSession
現在のセッションで作成されたすべてのセッションを取得します。
Name、ID、InstanceID、State、ApplicationName、ConfigurationName などのフィルター処理パラメーターを使用して、返されるGet-PSSession
セッションの中から選択します。
ComputerName パラメーターまたは ConnectionUri パラメーターを使用するときにコマンドがGet-PSSession
実行される一時的な接続を構成するには、残りのパラメーターを使用します。
注意
Windows PowerShell 2.0 では、パラメーターを指定せずに、Get-PSSession
現在のセッションで作成されたすべてのセッションを取得します。 ComputerName パラメーターは、現在のセッションで作成されたセッションを取得し、指定したコンピューターに接続します。
PowerShell セッションの詳細については、「 about_PSSessions」を参照してください。
例
例 1: 現在のセッションで作成されたセッションを取得する
Get-PSSession
このコマンドは、現在のセッションで作成されたすべての PSSession を取得します。 このコンピューターに接続しても、他のセッションまたは他のコンピューターで作成された PSSession は取得されません。
例 2: ローカル コンピューターに接続されているセッションを取得する
Get-PSSession -ComputerName "localhost"
このコマンドは、ローカル コンピューターに接続されている PSSession を 取得します。 ローカル コンピューターを示すには、コンピューター名、localhost、またはドット (.
) を入力します。
このコマンドは、別のセッションまたは別のコンピューターで作成された場合でも、ローカル コンピューター上のセッションをすべて返します。
例 3: コンピューターに接続されているセッションを取得する
Get-PSSession -ComputerName "Server02"
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
2 Session3 Server02 Disconnected ITTasks Busy
1 ScheduledJobs Server02 Opened Microsoft.PowerShell Available
3 Test Server02 Disconnected Microsoft.PowerShell Busy
このコマンドは、Server02 コンピューターに接続されている PSSession を 取得します。
このコマンドは、別のセッションまたは別のコンピューターで作成された場合でも、Server02 上のセッションをすべて返します。
出力は、2 つのセッション Disconnected
の状態と可用性を Busy
示しています。
これらのセッション別のセッションで作成されており、現在使用されています。 セッション (ScheduledJobs
と ) はOpened
Available
、現在のセッションで作成されました。
例 4: このコマンドの結果を保存する
New-PSSession -ComputerName Server01, Server02, Server03
$s1, $s2, $s3 = Get-PSSession
この例では、コマンドの結果を複数の Get-PSSession
変数に保存する方法を示します。
最初のコマンドでは、 コマンドレットを New-PSSession
使用して、3 台のリモート コンピューターに PSSessions を作成します。
2 番目のコマンドでは、 コマンドレットを Get-PSSession
使用して 3 つの PSSession を取得します。 その後、各 PSSession を 個別の変数に保存します。
PowerShell は、オブジェクトの配列を変数の配列に割り当てると、最初のオブジェクトを最初の変数に割り当て、2 番目のオブジェクトを 2 番目の変数に割り当てます。 オブジェクトの数が変数の数よりも多い場合、残りのオブジェクトはすべて配列の最後の変数に割り当てられます。 変数の数がオブジェクトの数よりも多い場合、余分な変数は使用されません。
例 5: インスタンス ID を使用してセッションを削除する
Get-PSSession | Format-Table -Property ComputerName, InstanceID
$s = Get-PSSession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f
Remove-PSSession -Session $s
この例では、インスタンス ID を使用して PSSession を取得し、 PSSession を削除する方法を示します。
最初のコマンドは、現在のセッションで作成されたすべての PSSession を取得します。 PSSessions を コマンドレットにFormat-Table
送信し、各 PSSession の ComputerName プロパティと InstanceID プロパティを表示します。
2 番目のコマンドでは、 コマンドレットを Get-PSSession
使用して特定の PSSession を取得し、変数に $s
保存します。 コマンドは InstanceID パラメーターを使用して PSSession を識別します。
3 番目のコマンドでは、Remove-PSSession コマンドレットを使用して、 変数の PSSession を $s
削除します。
例 6: 特定の名前を持つセッションを取得する
この例のコマンドは、特定の名前形式に準拠し、特定のセッション構成を使用するセッションを探して接続します。 このようなコマンドを使用すれば、同僚が開始したタスクのセッションを探して接続し、そのタスクを完了することができます。
Get-PSSession -ComputerName Server02, Server12 -Name BackupJob* -ConfigurationName ITTasks -SessionOption @{OperationTimeout=240000}
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
3 BackupJob04 Server02 Disconnected ITTasks None
$s = Get-PSSession -ComputerName Server02 -Name BackupJob04 -ConfigurationName ITTasks | Connect-PSSession
$s
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
5 BackupJob04 Server02 Opened ITTasks Available
最初のコマンドは、セッション構成で始まり、使用する名前を持つ Server02 および Server12 リモート コンピューター上 BackupJob
のセッションを ITTasks
取得します。コマンドは Name パラメーターを使用して名前パターンを指定し、 ConfigurationName パラメーターを使用してセッション構成を指定します。 SessionOption パラメーターの値は、OperationTimeout の値をミリ秒 (4 分) に設定する240000
ハッシュ テーブルです。 この設定により、コマンドの完了時間が長くなります。 ConfigurationName パラメーターと SessionOption パラメーターは、コマンドレットが各コンピューターで実行される一時的なセッションを Get-PSSession
構成するために使用されます。出力は、コマンドがセッションを BackupJob04
返したことを示しています。 セッションは切断され、 可用性 は None
であり、使用されていないことを示します。
2 番目のコマンドでは、 コマンドレットを Get-PSSession
使用してセッションに BackupJob04
アクセスし、コマンドレットを Connect-PSSession
使用してセッションに接続します。 このコマンドでは、セッションが $s
変数に保存されます。
3 番目のコマンドは、 変数内のセッションを $s
取得します。 出力は、コマンドが Connect-PSSession
成功したことを示しています。 このセッションは、Opened 状態にあり、使用可能です。
例 7: その ID を使用してセッションを取得する
Get-PSSession -Id 2
このコマンドは、ID を持つ PSSession を 2
取得します。 ID プロパティの値は現在のセッションでのみ一意であるため、Id パラメーターはローカル コマンドに対してのみ有効です。
パラメーター
-AllowRedirection
このコマンドレットによって、代替の Uniform Resource Identifier (URI) へのこの接続のリダイレクトが許可されることを示します。 既定では、PowerShell は接続をリダイレクトしません。
このパラメーターは、ConnectionUri パラメーターを使用してコマンドを実行するために作成される一時的なGet-PSSession
接続を構成します。
このパラメーターは Windows PowerShell 3.0 で導入されました。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationName
アプリケーションの名前を指定します。 このコマンドレットは、指定したアプリケーションを使用するセッションにのみ接続します。
接続 URI のアプリケーション名セグメントを入力します。 たとえば、次の接続 URI では、アプリケーション名は WSMan: http://localhost:5985/WSMAN
です。 セッションのアプリケーション名は、セッションの Runspace.ConnectionInfo.AppName プロパティに保存されています。
このパラメーター値は、セッションを選択してフィルター処理するために使用されます。 セッションが使用するアプリケーションが変更されることはありません。
Type: | String |
Position: | Named |
Default value: | All sessions |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Authentication
コマンドが実行されるセッションの資格情報を認証するために使用されるメカニズムを Get-PSSession
指定します。
このパラメーターは、ComputerName パラメーターまたは ConnectionUri パラメーターを使用してコマンドをGet-PSSession
実行するために作成される一時的な接続を構成します。
このパラメーターの有効値は、次のとおりです。
Default
Basic
CredSSP
Digest
Kerberos
Negotiate
NegotiateWithImplicitCredential
.
既定値は Default
です。
このパラメーターの値の詳細については、「 AuthenticationMechanism 列挙」を参照してください。
注意事項
ユーザーの資格情報が認証対象のリモート コンピューターに渡される Credential Security Support Provider (CredSSP) 認証は、リモート ネットワーク共有にアクセスする場合など、複数のリソースの認証を必要とするコマンドを対象としています。 このメカニズムを使用すると、リモート操作のセキュリティ リスクが高まります。 リモート コンピューターのセキュリティが低下している場合は、そのリモート コンピューターに渡される資格情報を使用してネットワーク セッションが制御される場合があります。
このパラメーターは Windows PowerShell 3.0 で導入されました。
Type: | AuthenticationMechanism |
Accepted values: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
Position: | Named |
Default value: | Default |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
コマンドを実行するセッションを作成するアクセス許可を持つユーザー アカウントのデジタル公開キー証明書 (X509) を Get-PSSession
指定します。 証明書の拇印を入力します。
このパラメーターは、ComputerName または ConnectionUri パラメーターを使用してコマンドをGet-PSSession
実行するために作成される一時的な接続を構成します。
証明書は、クライアント証明書ベースの認証で使用されます。 これらの証明書は、ローカル ユーザー アカウントにしかマップできません。ドメイン アカウントでは機能しません。
証明書の拇印を取得するには、PowerShell Cert:
ドライブで または Get-ChildItem
コマンドを使用Get-Item
します。
このパラメーターは Windows PowerShell 3.0 で導入されました。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
コンピューターの名前の配列を指定します。 指定されたコンピューターに接続しているセッションを取得します。 ワイルドカード文字は使用できません。 既定値はありません。
Windows PowerShell 3.0 以降では、PSSession オブジェクトは各接続のリモート側のコンピューターに格納されます。 指定したコンピューターでセッションを取得するために、PowerShell は各コンピューターへの一時的な接続を作成し、コマンドを Get-PSSession
実行します。
1 台以上のコンピューターの NetBIOS 名、IP アドレス、または完全修飾ドメイン名を入力します。 ローカル コンピューターを指定するには、コンピューター名、、 localhost
またはドット (.
) を入力します。
注意
このパラメーターは、PowerShell Windows PowerShell 3.0 以降のバージョンを実行しているコンピューターからのみセッションを取得します。 それ以前のバージョンではセッションが保存されません。
Type: | String[] |
Aliases: | Cn |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConfigurationName
構成の名前を指定します。 このコマンドレットは、指定されたセッション構成を使用するセッションにのみ取得されます。
セッション構成の構成名または完全修飾リソース URI を入力します。 構成名のみを指定した場合は、次のスキーマ URI が先頭に付加されます。 http://schemas.microsoft.com/powershell
セッションの構成名は、セッションの ConfigurationName プロパティに保存されています。
このパラメーター値は、セッションを選択してフィルター処理するために使用されます。 セッションが使用するセッション構成が変更されることはありません。
セッション構成の詳細については、「 about_Session_Configurations」を参照してください。
Type: | String |
Position: | Named |
Default value: | All sessions |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConnectionUri
コマンドが実行される一時セッションの接続エンドポイントを定義する URI を Get-PSSession
指定します。 URI は完全修飾名にする必要があります。
このパラメーターは、ConnectionUri パラメーターを使用してコマンドを実行するために作成される一時的なGet-PSSession
接続を構成します。
この文字列の形式は次のとおりです。
<Transport>://<ComputerName>:<Port\>/<ApplicationName>
既定値は http://localhost:5985/WSMAN
です。
ConnectionUri を指定しない場合は、UseSSL、ComputerName、Port、および ApplicationName パラメーターを使用して ConnectionURI 値を指定できます。 URI のトランスポート セグメントの有効な値は、HTTP および HTTPS です。 トランスポート セグメントを使用して接続 URI を指定し、ポートを指定しない場合、セッションは標準ポート (HTTP 用と 443
HTTPS 用) 80
で作成されます。 PowerShell リモート処理に既定のポートを使用するには、HTTP または 5986
HTTPS のポート5985
を指定します。
宛先コンピューターが接続を別の URI にリダイレクトする場合、コマンドで AllowRedirection パラメーターを使用しない限り、PowerShell はリダイレクトを防止します。
このパラメーターは Windows PowerShell 3.0 で導入されました。
このパラメーターは、Windows PowerShellの 3.0 以降のバージョンWindows PowerShell実行されているコンピューターからのみセッションを取得します。 それ以前のバージョンではセッションが保存されません。
Type: | Uri[] |
Aliases: | URI, CU |
Position: | 0 |
Default value: | Http://localhost:5985/WSMAN |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ContainerId
コンテナーの ID の配列を指定します。 このコマンドレットは、指定された各コンテナーとの対話型セッションを開始します。 コマンドを docker ps
使用して、コンテナー ID の一覧を取得します。 詳細については、 docker ps コマンドのヘルプを参照してください。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Credential
ユーザー資格情報を指定します。 このコマンドレットは、指定したユーザーのアクセス許可を使用してコマンドを実行します。 リモート コンピューターに接続してコマンドを実行するアクセス許可を持つユーザー アカウントを Get-PSSession
指定します。 既定値は現在のユーザーです。
や Domain01\User01
などのUser01
ユーザー名を入力するか、 コマンドレットによって生成された PSCredential オブジェクトをGet-Credential
入力します。 ユーザー名を入力すると、パスワードの入力を求められます。
資格情報は PSCredential オブジェクトに 格納され、パスワードは SecureString として格納されます。
注意
SecureString データ保護の詳細については、「SecureString のセキュリティ保護方法」を参照してください。
このパラメーターは、ComputerName パラメーターまたは ConnectionUri パラメーターを使用してコマンドを実行するために作成される一時的なGet-PSSession
接続に対して構成します。
このパラメーターは Windows PowerShell 3.0 で導入されました。
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
セッション ID の配列を指定します。 このコマンドレットは、指定された ID を持つセッションのみを取得します。 1 つ以上の ID をコンマで区切って入力するか、範囲演算子 (..
) を使用して ID の範囲を指定します。
COMPUTERName パラメーターと共に ID パラメーターを使用することはできません。
ID は、現在のセッション内のユーザー管理セッションを一意に識別する整数です。 InstanceId よりも覚えて入力する方が簡単ですが、現在のセッション内でのみ一意です。 セッションの ID は、セッションの ID プロパティに格納されます。
Type: | Int32[] |
Position: | 0 |
Default value: | All sessions |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceId
セッションのインスタンス ID の配列を指定します。 このコマンドレットは、指定されたインスタンス ID を持つセッションのみを取得します。
インスタンス ID は、ローカル コンピューターまたはリモート コンピューターのセッションを一意に識別する GUID です。 InstanceID は、PowerShell で複数のセッションが実行されている場合でも一意です。
セッションのインスタンス ID は、セッションの InstanceID プロパティに保存されています。
Type: | Guid[] |
Position: | Named |
Default value: | All sessions |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
セッション名の配列を指定します。 このコマンドレットは、指定されたフレンドリ名を持つセッションのみを取得します。 ワイルドカード文字を使用できます。
セッションのフレンドリ名は、セッションの Name プロパティに保存されています。
Type: | String[] |
Position: | Named |
Default value: | All sessions |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Port
コマンドが実行される一時的な接続に使用される、指定されたネットワーク ポートを Get-PSSession
指定します。 リモート コンピューターに接続するには、リモート コンピューターで、接続に使用されるポートをリッスンすることが必要です。 既定のポートは です 5985
。これは HTTP の WinRM ポートであり 5986
、HTTPS の WinRM ポートです。
代替ポートを使用する前に、そのポートでリッスンするようにリモート コンピューター上の WinRM リスナーを構成する必要があります。 リスナーを構成するには、PowerShell プロンプトで次の 2 つのコマンドを入力します。
Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse
New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port \<port-number\>
このパラメーターは、ComputerName パラメーターまたは ConnectionUri パラメーターを使用してコマンドを実行するために作成される一時的なGet-PSSession
接続に対して構成します。
必要な場合を除き、Port パラメーターを使用しないでください。 コマンドで設定された ポート は、コマンドを実行するすべてのコンピューターまたはセッションに適用されます。 代替ポートの設定によっては、コマンドがすべてのコンピューターで実行されない場合があります。
このパラメーターは Windows PowerShell 3.0 で導入されました。
Type: | Int32 |
Position: | Named |
Default value: | 5985, 5986 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SessionOption
セッションの詳細オプションを指定します。 コマンドレットを使用New-PSSessionOption
して作成した SessionOption オブジェクトや、キーがセッション オプション名で値がセッション オプション値であるハッシュ テーブルを入力します。
オプションの既定値は、設定されている場合は、基本設定変数の $PSSessionOption
値によって決まります。 それ以外の場合、既定値はセッション構成で設定されたオプションによって決まります。
セッション オプションの値は、基本設定変数とセッション構成で設定された $PSSessionOption
セッションの既定値よりも優先されます。 ただし、セッション構成で設定された最大値、クォータ、または制限よりも優先されることはありません。
既定値を含むセッション オプションの説明については、「」を参照してください New-PSSessionOption
。
基本設定変数の $PSSessionOption
詳細については、「 about_Preference_Variables」を参照してください。 セッション構成の詳細については、「 about_Session_Configurations」を参照してください。
Type: | PSSessionOption |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
セッション状態を指定します。 このコマンドレットは、指定された状態のセッションのみを取得します。 このパラメーターに使用できる値は、All
、、Opened
、Disconnected
Closed
、および Broken
です。 既定値は All
です。
セッション状態の値は、現在のセッションを基準にしています。 現在のセッションで作成されておらず、現在のセッションに接続されていないセッションは、別の Disconnected
セッションに接続されている場合でも の状態になります。
セッションの状態は、セッションの State プロパティに保存されています。
このパラメーターは Windows PowerShell 3.0 で導入されました。
Type: | SessionFilterState |
Accepted values: | All, Opened, Disconnected, Closed, Broken |
Position: | Named |
Default value: | All |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottleLimit
コマンドを実行するために確立できる同時接続の最大数を Get-PSSession
指定します。 このパラメーターを省略するか、値 0
(ゼロ) を入力すると、 32
既定値 の が使用されます。 スロットル制限は現在のコマンドのみに適用され、セッションまたはコンピューターには適用されません。
このパラメーターは Windows PowerShell 3.0 で導入されました。
Type: | Int32 |
Position: | Named |
Default value: | 32 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSSL
このコマンドレットが Secure Sockets Layer (SSL) プロトコルを使用して、コマンドを実行する接続を Get-PSSession
確立することを示します。 既定では、SSL は使用されません。 コマンドに使用するポートで SSL が使用できない場合に、このパラメーターを指定すると、コマンドは失敗します。
このパラメーターは、ComputerName パラメーターを使用してコマンドを実行するために作成される一時的なGet-PSSession
接続を構成します。
このパラメーターは Windows PowerShell 3.0 で導入されました。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMId
仮想マシンの ID の配列を指定します。 このコマンドレットは、指定された各仮想マシンとの対話型セッションを開始します。 使用可能な仮想マシンを表示するには、次のコマンドを使用します。
Get-VM | Select-Object -Property Name, ID
Type: | Guid[] |
Aliases: | VMGuid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMName
仮想マシンの名前の配列を指定します。 このコマンドレットは、指定された各仮想マシンとの対話型セッションを開始します。 使用可能な仮想マシンを表示するには、 コマンドレットを Get-VM
使用します。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
入力
None
パイプを使用してこのコマンドレットに入力を渡すことはできません。
出力
メモ
- このコマンドレットは、および
Invoke-Command
コマンドレットを使用して作成されたものなど、ユーザーが管理するセッション PSSession オブジェクトをNew-PSSession
Enter-PSSession
取得します。 PowerShell の起動時に作成されるシステムマネージド セッションは取得されません。 - Windows PowerShell 3.0 以降、PSSession オブジェクトは、サーバー側または接続の受信側にあるコンピューターに格納されます。 ローカル コンピューターまたはリモート コンピューターに格納されているセッションを取得するために、PowerShell は指定されたコンピューターへの一時的なセッションを確立し、セッションでクエリ コマンドを実行します。
- リモート コンピューターに接続しているセッションを取得するには、ComputerName パラメーターまたは ConnectionUri パラメーターを使用してリモート コンピューターを指定します。 取得するセッション
Get-PSSession
をフィルター処理するには、Name、ID、InstanceID、State の各パラメーターを使用します。 残りのパラメーターを使用して、 を使用する一時セッションをGet-PSSession
構成します。 - ComputerName パラメーターまたは ConnectionUri パラメーターを使用すると、
Get-PSSession
PowerShell Windows PowerShell 3.0 以降のバージョンを実行しているコンピューターからセッションのみを取得します。 - PSSession の State プロパティの値は、現在のセッションに対して相対的です。 したがって、 Disconnected の値は、 PSSession が現在のセッションに接続されていないことを意味します。 ただし、 PSSession がすべてのセッションから切断されているわけではありません。 別のセッションに接続されている可能性があるためです。 現在のセッションから PSSession に接続できるか、または PSSession に再接続できるかを確認するには、 Availability プロパティを使用します。
Availability の値が None の場合は、セッションに接続できることを示します。 [ビジー] の値は、PSSession が別のセッションに接続されているため、接続できないことを示します。
セッションの State プロパティの値の詳細については、「 RunspaceState 列挙」を参照してください。
セッションの Availability プロパティの値の詳細については、「 RunspaceAvailability 列挙」を参照してください。