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
現在のセッションで作成されたすべてのセッションを取得します。
返されるセッションGet-PSSession
の中から選択するには、名前、ID、InstanceID、State、ApplicationName、ConfigurationName などのフィルター処理パラメーターを使用します。
再メインパラメーターを使用して、ComputerName パラメーターまたは ConnectionUri パラメーターをGet-PSSession
使用するときにコマンドが実行される一時的な接続を構成します。
Note
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 台のリモート コンピューターに PSSession を作成します。
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 を取得します。 PSSession をコマンドレットに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
成功したことを示しています。 セッションは開いている状態であり、使用できます。
例 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 列挙型」を参照してください。
注意
ユーザーの資格情報が認証されるリモート コンピューターに渡される資格情報セキュリティ サポート プロバイダー (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:
ドライブで a または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
ドット (.
) を入力します。
Note
このパラメーターは、Windows PowerShell 3.0 以降のバージョンの PowerShell を実行しているコンピューターからのみセッションを取得します。 それ以前のバージョンではセッションが保存されません。
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 を指定したが、ポートを指定しない場合、セッションは標準ポート 80
(HTTP 用と 443
HTTPS 用) で作成されます。 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
指定します。 既定値は現在のユーザーです。
コマンドレットによってGet-Credential
生成された PSCredential オブジェクトなどのUser01
ユーザー名を入力するかDomain01\User01
、入力します。 ユーザー名を入力すると、パスワードの入力を求められます。
資格情報は PSCredential オブジェクトに格納され、パスワードは SecureString として格納されます。
Note
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 です。 PowerShell で複数の セッションが実行されている場合でも、InstanceID は一意です。
セッションのインスタンス 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
セッションの状態を指定します。 このコマンドレットは、指定された状態のセッションのみを取得します。 このパラメーターに使用できる値は、次Broken
Closed
Disconnected
Opened
のとおりです。 All
既定値は 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
このコマンドレットにオブジェクトをパイプすることはできません。
出力
メモ
PowerShell には、次のエイリアスが Get-PSSession
含まれています。
すべてのプラットフォーム:
gsn
このコマンドレットは、ユーザーが管理するセッション PSSession オブジェクトを取得します。
New-PSSession
Enter-PSSession
Invoke-Command
PowerShell の起動時に作成されるシステム管理セッションは取得されません。Windows PowerShell 3.0 以降では、 PSSession オブジェクトは、サーバー側または接続の受信側にあるコンピューターに格納されます。 ローカル コンピューターまたはリモート コンピューターに格納されているセッションを取得するために、PowerShell は指定されたコンピューターへの一時的なセッションを確立し、セッションでクエリ コマンドを実行します。
リモート コンピューターに接続するセッションを取得するには、ComputerName パラメーターまたは ConnectionUri パラメーターを使用してリモート コンピューターを指定します。 取得する
Get-PSSession
セッションをフィルター処理するには、Name、ID、InstanceID、State パラメーターを使用します。 reメインing パラメーターを使用して、使用する一時セッションをGet-PSSession
構成します。ComputerName パラメーターまたは ConnectionUri パラメーターを使用する場合は、
Get-PSSession
Windows PowerShell 3.0 以降のバージョンの PowerShell を実行しているコンピューターからのセッションのみを取得します。PSSession の State プロパティの 値は、現在のセッションを 基準にしています。 したがって、Disconnected の値は、PSSession が現在のセッションに接続されていないことを意味します。 ただし、PSSession がすべてのセッションから切断されているわけではありません。 別のセッションに接続されている可能性があるためです。 現在のセッションから PSSession に接続できるか再接続できるかを確認するには、Availability プロパティを使用します。
可用性の値 None は、セッションに接続できることを示します。 [ビジー] の値は、PSSession が別のセッションに接続されているため、PSSession に接続できないことを示します。
セッションの State プロパティの値の詳細については、「RunspaceState 列挙型」を参照してください。
セッションの Availability プロパティの値の詳細については、「RunspaceAvailability 列挙型」を参照してください。
関連リンク
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示