Get-PSSession

リファレンス

モジュール:: Microsoft.PowerShell.Core

ローカルコンピューターとリモートコンピューター上の 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 つのセッションが状態と可用性をDisconnectedBusy持っていることを示しています。これらのセッション別のセッションで作成されており、現在使用されています。セッションは ScheduledJobsOpenedAvailable、現在のセッションで作成されました。

例 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 指定します。証明書の拇印を入力します。

証明書は、クライアント証明書ベースの認証で使用されます。これらの証明書は、ローカルユーザーアカウントにしかマップできません。ドメインアカウントでは機能しません。

証明書の拇印を取得するには、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\>

必要な場合を除き、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

セッションの状態を指定します。このコマンドレットは、指定された状態のセッションのみを取得します。このパラメーターに使用できる値は、次BrokenClosedDisconnectedOpenedのとおりです。 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

このコマンドレットにオブジェクトをパイプすることはできません。

出力

PSSession

メモ

PowerShell には、次のエイリアスが Get-PSSession含まれています。

すべてのプラットフォーム:
- gsn
このコマンドレットは、ユーザーが管理するセッション PSSession オブジェクトを取得します。New-PSSessionEnter-PSSessionInvoke-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 列挙型」を参照してください。

Get-PSSession

構文

説明

例

例 1: 現在のセッションで作成されたセッションを取得する

例 2: ローカルコンピューターに接続されているセッションを取得する

例 3: コンピューターに接続されているセッションを取得する

例 4: このコマンドの結果を保存する

例 5: インスタンス ID を使用してセッションを削除する

例 6: 特定の名前を持つセッションを取得する

例 7: その ID を使用してセッションを取得する

パラメーター

-AllowRedirection

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConfigurationName

-ConnectionUri

-ContainerId

-Credential

-Id

-InstanceId

-Name

-Port

-SessionOption

-State

-ThrottleLimit

-UseSSL

-VMId

-VMName

入力

出力

メモ

フィードバック

その他のリソース

Get-PSSession

構文

説明

例

例 1: 現在のセッションで作成されたセッションを取得する

例 2: ローカル コンピューターに接続されているセッションを取得する

例 3: コンピューターに接続されているセッションを取得する

例 4: このコマンドの結果を保存する

例 5: インスタンス ID を使用してセッションを削除する

例 6: 特定の名前を持つセッションを取得する

例 7: その ID を使用してセッションを取得する

パラメーター

-AllowRedirection

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConfigurationName

-ConnectionUri

-ContainerId

-Credential

-Id

-InstanceId

-Name

-Port

-SessionOption

-State

-ThrottleLimit

-UseSSL

-VMId

-VMName

入力

出力

メモ

関連リンク

フィードバック

その他のリソース

例 2: ローカルコンピューターに接続されているセッションを取得する