Import-PSSession

リファレンス

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

別のセッションから現在のセッションにコマンドをインポートします。

構文

Import-PSSession
      [-Prefix <String>]
      [-DisableNameChecking]
      [[-CommandName] <String[]>]
      [-AllowClobber]
      [-ArgumentList <Object[]>]
      [-CommandType <CommandTypes>]
      [-Module <String[]>]
      [-FullyQualifiedModule <ModuleSpecification[]>]
      [[-FormatTypeName] <String[]>]
      [-Certificate <X509Certificate2>]
      [-Session] <PSSession>
      [<CommonParameters>]

説明

Import-PSSession コマンドレットは、コマンドレット、関数、エイリアスなどのコマンドを、ローカルコンピューターまたはリモートコンピューター上の PSSession から現在のセッションにインポートします。 Get-Command コマンドレットが PSSession で検索できる任意のコマンドをインポートできます。

Import-PSSession コマンドを使用して、Microsoft Exchange Server シェルなどのカスタマイズされたシェルから、または Windows PowerShell モジュールやスナップイン、または現在のセッションに含まれていないその他の要素を含むセッションからコマンドをインポートします。

コマンドをインポートするには、まず New-PSSession コマンドレットを使用して PSSession を作成します。次に、 Import-PSSession コマンドレットを使用してコマンドをインポートします。既定では、 Import-PSSession は、現在のセッションのコマンドと同じ名前のコマンドを除くすべてのコマンドをインポートします。すべてのコマンドをインポートするには、 AllowClobber パラメーターを使用します。

インポートしたコマンドは、セッションのコマンドを使用する場合と同じように使用できます。インポートしたコマンドを使用すると、インポートした部分のコマンドがインポート元のセッションで暗黙的に実行されます。ただし、リモート操作はすべて Windows PowerShell によって処理されます。リモート操作に注意を払う必要はありませんが、もう一方のセッション (PSSession) への接続を開いたままにする必要があります。接続を閉じると、インポートしたコマンドを利用できなくなります。

インポートされたコマンドはローカルコマンドよりも実行に時間がかかる場合があるため、 Import-PSSession はインポートされたすべてのコマンドに AsJob パラメーターを追加します。このパラメーターを使用すると、コマンドを Windows PowerShell のバックグラウンドジョブとして実行することができます。詳細については、「about_Jobs」を参照してください。

Import-PSSessionを使用すると、Windows PowerShell は、セッションにのみ存在する一時モジュールにインポートされたコマンドを追加し、モジュールを表すオブジェクトを返します。今後のセッションで使用できる永続的なモジュールを作成するには、 Export-PSSession コマンドレットを使用します。

Import-PSSession コマンドレットは、Windows PowerShell の暗黙的なリモート処理機能を使用します。現在のセッションにインポートされたコマンドは、インポート元のコンピューターの元のセッションまたは同様のセッションで暗黙的に実行されます。

Windows PowerShell 3.0 以降では、 Import-Module コマンドレットを使用して、リモートセッションから現在のセッションにモジュールをインポートできます。この機能では、暗黙的なリモート処理が使用されます。 Import-PSSessionを使用して、選択したモジュールをリモートセッションから現在のセッションにインポートすることと同じです。

例

例 1: PSSession からすべてのコマンドをインポートする

$S = New-PSSession -ComputerName Server01
Import-PSSession -Session $S

このコマンドは、Server01 コンピューターの PSSession から現在のセッションに、現在のセッションのコマンドと同じ名前のコマンドを除くすべてのコマンドをインポートします。

このコマンドは CommandName パラメーターを使用しないため、インポートされたコマンドに必要なすべての書式設定データもインポートします。

例 2: 特定の文字列で終わるコマンドをインポートする

$S = New-PSSession https://ps.testlabs.com/powershell
Import-PSSession -Session $S -CommandName *-test -FormatTypeName *
New-Test -Name Test1
Get-Test test1 | Run-Test

これらのコマンドは、PSSession からローカルセッションに名前が "-test" で終わるコマンドをインポートします。その後、インポートしたコマンドレットを使用する方法も示します。

最初のコマンドでは、 New-PSSession コマンドレットを使用して PSSession を作成します。 PSSession を $S 変数に保存します。

2 番目のコマンドでは、 Import-PSSession コマンドレットを使用して、 $S の PSSession から現在のセッションにコマンドをインポートします。 CommandName パラメーターを使用して、Test 名詞と FormatTypeName パラメーターを使用して、Test コマンドの書式設定データをインポートするコマンドを指定します。

3 番目と 4 番目のコマンドは、現在のセッションでインポートされたコマンドを使用します。インポートされたコマンドは、現在のセッションに実際に追加されるため、ローカル構文を使用して実行できます。インポートされたコマンドを実行するために、 Invoke-Command コマンドレットを使用する必要はありません。

例 3: PSSession からコマンドレットをインポートする

$S1 = New-PSSession -ComputerName s1
$S2 = New-PSSession -ComputerName s2
Import-PSSession -Session s1 -Type cmdlet -Name New-Test, Get-Test -FormatTypeName *
Import-PSSession -Session s2 -Type Cmdlet -Name Set-Test -FormatTypeName *
New-Test Test1 | Set-Test -RunType Full

この例では、ローカルのコマンドレットを使用するのと同じように、インポートされたコマンドレットを使用できることを示します。

これらのコマンドは、server01 コンピューターの PSSession から New-Test コマンドレットと Get-Test コマンドレットをインポートし、Server02 コンピューターの PSSession から Set-Test コマンドレットをインポートします。

別々の PSSession からコマンドレットをインポートした場合でも、パイプを使用して 1 つのコマンドレットから別のコマンドレットにオブジェクトを渡すことができます。エラーにはなりません。

例 4: インポートされたコマンドをバックグラウンドジョブとして実行する

$S = New-PSSession -ComputerName Server01
Import-PSSession -Session $S -CommandName *-test* -FormatTypeName *
$batch = New-Test -Name Batch -AsJob
Receive-Job $batch

この例では、インポートしたコマンドをバックグラウンドジョブとして実行する方法を示します。

インポートされたコマンドはローカルコマンドよりも実行に時間がかかる場合があるため、 Import-PSSession はインポートされたすべてのコマンドに AsJob パラメーターを追加します。 AsJob パラメーターを使用すると、バックグラウンドジョブとしてコマンドを実行できます。

最初のコマンドは、Server01 コンピューターに PSSession を作成し、PSSession オブジェクトを $S 変数に保存します。

2 番目のコマンドでは、 Import-PSSession を使用して、 $S の PSSession から現在のセッションに Test コマンドレットをインポートします。

3 番目のコマンドでは、インポートされたNew-Test コマンドレットの AsJob パラメーターを使用して、New-Test コマンドをバックグラウンドジョブとして実行します。このコマンドは、 New-Test 返されるジョブオブジェクトを $batch 変数に保存します。

4 番目のコマンドでは、 Receive-Job コマンドレットを使用して、 $batch 変数内のジョブの結果を取得します。

例 5: Windows PowerShell モジュールからコマンドレットと関数をインポートする

$S = New-PSSession -ComputerName Server01
Invoke-Command -Session $S {Import-Module TestManagement}
Import-PSSession -Session $S -Module TestManagement

この例では、リモートコンピューターの Windows PowerShell モジュールから現在のセッションにコマンドレットと関数をインポートする方法を示します。

最初のコマンドは、Server01 コンピューターに PSSession を作成し、 $S 変数に保存します。

2 番目のコマンドでは、Invoke-Command コマンドレットを使用して、$Sの PSSession で Import-Module コマンドを実行します。

通常、モジュールは Windows PowerShell プロファイルの Import-Module コマンドによってすべてのセッションに追加されますが、プロファイルは PSSession では実行されません。

3 番目のコマンドでは、Import-PSSessionの Module パラメーターを使用して、モジュール内のコマンドレットと関数を現在のセッションにインポートします。

例 6: 一時ファイルにモジュールを作成する

PS C:\> Import-PSSession $S -CommandName Get-Date, SearchHelp -FormatTypeName * -AllowClobber

Name              : tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1zunz.ttf
Path              : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1
zunz.ttf\tmp_79468106-4e1d-4d90-af97-1154f9317239_
tcw1zunz.ttf.psm1
Description       : Implicit remoting for http://server01.corp.fabrikam.com/wsman
Guid              : 79468106-4e1d-4d90-af97-1154f9317239
Version           : 1.0
ModuleBase        : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1
zunz.ttf
ModuleType        : Script
PrivateData       : {ImplicitRemoting}
AccessMode        : ReadWrite
ExportedAliases   : {}
ExportedCmdlets   : {}
ExportedFunctions : {[Get-Date, Get-Date], [SearchHelp, SearchHelp]}
ExportedVariables : {}
NestedModules     : {}

この例は、 Import-PSSession がディスク上の一時ファイルにモジュールを作成することを示しています。また、現在のセッションにインポートする前に、すべてのコマンドを関数に変換します。

このコマンドでは、 Import-PSSession コマンドレットを使用して、 Get-Date コマンドレットと SearchHelp 関数を現在のセッションにインポートします。

Import-PSSession コマンドレットは、一時モジュールを表すPSModuleInfo オブジェクトを返します。 Path プロパティの値は、スクリプトモジュール (.psm1) ファイルImport-PSSession一時的な場所に作成されたことを示しています。 ExportedFunctions プロパティは、Get-Date コマンドレットと SearchHelp 関数の両方が関数としてインポートされたことを示します。

例 7: インポートされたコマンドで非表示になっているコマンドを実行する

PS C:\> Import-PSSession $S -CommandName Get-Date -FormatTypeName * -AllowClobber

PS C:\> Get-Command Get-Date -All

CommandType   Name       Definition
-----------   ----       ----------
Function      Get-Date   ...
Cmdlet        Get-Date   Get-Date [[-Date] <DateTime>] [-Year <Int32>] [-Month <Int32>]

PS C:\> Get-Date
09074

PS C:\> (Get-Command -Type Cmdlet -Name Get-Date).PSSnapin.Name
Microsoft.PowerShell.Utility

PS C:\> Microsoft.PowerShell.Utility\Get-Date
Sunday, March 15, 2009 2:08:26 PM

この例では、インポートされたコマンドによって非表示になったコマンドを実行する方法を示します。

最初のコマンドは、$S変数の PSSession から Get-Date コマンドレットをインポートします。現在のセッションには Get-Date コマンドレットが含まれているため、コマンドには AllowClobber パラメーターが必要です。

2 番目のコマンドでは、Get-Command コマンドレットの All パラメーターを使用して、現在のセッションのすべてのGet-Date コマンドを取得します。出力は、セッションに元の Get-Date コマンドレットと Get-Date 関数が含まれていることを示しています。 Get-Date関数は、$Sの PSSession でインポートされたGet-Date コマンドレットを実行します。

3 番目のコマンドは、 Get-Date コマンドを実行します。関数はコマンドレットよりも優先されるため、Windows PowerShell はインポートされた Get-Date 関数を実行し、ユリウス日を返します。

4 番目と 5 番目のコマンドは、修飾名を使用して、インポートされたコマンドによって非表示になったコマンドを実行する方法を示しています。

4 番目のコマンドは、元の Get-Date コマンドレットを現在のセッションに追加した Windows PowerShell スナップインの名前を取得します。

5 番目のコマンドでは、 Get-Date コマンドレットのスナップイン名を使用して、 Get-Date コマンドを実行します。

コマンドの優先順位と非表示のコマンドの詳細については、 about_Command_Precedenceを参照してください。

例 8: 名前に特定の文字列を含むコマンドをインポートする

PS C:\> Import-PSSession -Session $S -CommandName **Item** -AllowClobber

このコマンドは、 $Sの PSSession の Item を含む名前のコマンドをインポートします。コマンドには CommandName パラメーターが含まれていますが、 FormatTypeData パラメーターは含まれていないため、コマンドのみがインポートされます。

Import-PSSessionを使用してリモートコンピューターでコマンドを実行し、現在のセッションでコマンドの書式設定データが既にある場合は、このコマンドを使用します。

例 9: Module パラメーターを使用して、セッションにインポートされたコマンドを検出する

PS C:\> $M = Import-PSSession -Session $S -CommandName *bits* -FormatTypeName *bits*
PS C:\> Get-Command -Module $M
CommandType     Name
-----------     ----
Function        Add-BitsFile
Function        Complete-BitsTransfer
Function        Get-BitsTransfer
Function        Remove-BitsTransfer
Function        Resume-BitsTransfer
Function        Set-BitsTransfer
Function        Start-BitsTransfer
Function        Suspend-BitsTransfer

このコマンドは、Get-Commandの Module パラメーターを使用して、Import-PSSession コマンドによってセッションにインポートされたコマンドを確認する方法を示します。

最初のコマンドでは、 Import-PSSession コマンドレットを使用して、名前に PSSession の "bits" が含まれるコマンドを $S 変数にインポートします。 Import-PSSession コマンドは一時モジュールを返し、コマンドはモジュールを $m 変数に保存します。

2 番目のコマンドでは、 Get-Command コマンドレットを使用して、モジュールによってエクスポートされたコマンドを $M 変数に取得します。

Module パラメーターは、モジュール名用に設計された文字列値を受け取ります。ただし、モジュールオブジェクトを送信すると、Windows PowerShell はモジュールオブジェクトに対して ToString メソッドを使用し、モジュール名を返します。

Get-Command コマンドは、Get-Command $M.Name" に相当します。

パラメーター

-AllowClobber

指定したコマンドが現在のセッションのコマンドと同じ名前であっても、このコマンドレットによってインポートされることを示します。

現在のセッションにあるコマンドと同じ名前のコマンドをインポートする場合、インポートされたコマンドを非表示にするか、元のコマンドを置き換えます。詳細については、「about_Command_Precedence」(コマンドの優先順位について) を参照してください。

既定では、 Import-PSSession は現在のセッションのコマンドと同じ名前のコマンドをインポートしません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ArgumentList

指定した引数 (パラメーター値) を使用した結果のコマンドの配列を指定します。

たとえば、$Sの PSSession の証明書 (Cert:) ドライブに Get-Item コマンドのバリアントをインポートするには、「Import-PSSession -Session $S -Command Get-Item -ArgumentList cert:」と入力します。

型:	Object[]
Aliases:	Args
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Certificate

フォーマットファイル (*) の署名に使用するクライアント証明書を指定します。Format.ps1xml) またはスクリプトモジュールファイル (.psm1) を作成 Import-PSSession 一時モジュール内。

証明書が格納されている変数を入力するか、証明書を取得するコマンドまたは式を入力します。

証明書を検索するには、 Get-PfxCertificate コマンドレットを使用するか、証明書 (Cert:) ドライブの Get-ChildItem コマンドレットを使用します。証明書が無効な場合、または証明書に十分な権限がない場合、コマンドは失敗します。

型:	X509Certificate2
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CommandName

指定した名前または名前パターンを持つコマンドを指定します。ワイルドカードを使用できます。 CommandName またはそのエイリアスである Name を使用します。

既定では、 Import-PSSession は、現在のセッションのコマンドと同じ名前のコマンドを除き、セッションからすべてのコマンドをインポートします。そのため、インポート先のセッションでインポートしたコマンドが非表示になることや、置き換えられることがありません。他のコマンドを非表示または置き換えるコマンドであっても、すべてのコマンドをインポートするには、 AllowClobber パラメーターを使用します。

CommandName パラメーターを使用する場合、FormatTypeName パラメーターを使用しない限り、コマンドの書式設定ファイルはインポートされません。同様に、 FormatTypeName パラメーターを使用する場合、 CommandName パラメーターを使用しない限り、コマンドはインポートされません。

型:	String[]
Aliases:	Name
配置:	2
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CommandType

コマンドオブジェクトの種類を指定します。既定値は Cmdlet です。 CommandType またはそのエイリアスである Type を使用します。このパラメーターの有効値は、次のとおりです。

Alias: リモートセッションの Windows PowerShell エイリアス。
All: リモートセッションのコマンドレットと関数。
Application: リモートセッションの Path 環境変数 ($env:path) に一覧表示されているパス内の Windows-PowerShell ファイル以外のすべてのファイル (.txt、.exe、.dll ファイルなど)。
Cmdlet: リモートセッションのコマンドレット。 "Cmdlet" が既定値です。
ExternalScript: リモートセッションの Path 環境変数 ($env:path) にリストされているパス内の .ps1 ファイル。
Filter と Function: Windows PowerShell はリモートセッションで機能します。
Script: スクリプトはリモートセッションでブロックします。

これらの値は、フラグベースの列挙体として定義されます。このパラメーターを使用して、複数の値を組み合わせて複数のフラグを設定できます。値は、 CommandType パラメーターに値の配列として、またはそれらの値のコンマ区切り文字列として渡すことができます。コマンドレットは、バイナリ OR 操作を使用して値を結合します。配列として値を渡すことは最も簡単なオプションであり、値にタブ補完を使用することもできます。

型:	CommandTypes
Aliases:	Type
指定可能な値:	Alias, Function, Filter, Cmdlet, ExternalScript, Application, Script, Workflow, Configuration, All
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableNameChecking

名前に未承認の動詞または禁止文字が含まれるコマンドレットまたは関数をインポートするときに警告するメッセージが、このコマンドレットによって抑制されることを示します。

既定では、インポートしたモジュールによって、承認されていない動詞が名前に含まれているコマンドレットまたは関数がエクスポートされた場合に、Windows PowerShell によって次の警告メッセージが表示されます。

"警告: 一部のインポートされたコマンド名には未承認の動詞が含まれており、見つけにくくなることがあります。詳細または Get-Verb を入力して、承認された動詞の一覧を表示するには、Verbose パラメーターを使用します。"

このメッセージは警告のみです。実際には、非準拠のコマンドを含む、すべてのモジュールがインポートされます。モジュールユーザーにメッセージが表示されますが、名前付けの問題はモジュール作成者が解決する必要があります。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FormatTypeName

指定した Microsoft .NET Framework 型の書式設定手順を指定します。型名を入力します。ワイルドカードを使用できます。

このパラメーターの値は、コマンドのインポート元のセッションで Get-FormatData コマンドによって返される型の名前である必要があります。リモートセッションのすべての書式設定データを取得するには、「 *」と入力します。

コマンドに CommandName または FormatTypeName パラメーターが含まれていない場合、 Import-PSSession はリモートセッションの Get-FormatData コマンドによって返されるすべての .NET Framework 型の書式設定命令をインポートします。

FormatTypeName パラメーターを使用する場合、CommandName パラメーターを使用しない限り、コマンドはインポートされません。

同様に、 CommandName パラメーターを使用する場合、 FormatTypeName パラメーターを使用しない限り、コマンドの書式設定ファイルはインポートされません。

型:	String[]
配置:	3
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FullyQualifiedModule

値には、モジュール名、完全なモジュール仕様、またはモジュールファイルへのパスを指定できます。

値がパスの場合、パスは完全修飾または相対パスにすることができます。相対パスは、using ステートメントを含むスクリプトを基準にして解決されます。

値が名前またはモジュールの指定である場合、PowerShell は指定されたモジュールの PSModulePath を検索します。

モジュール仕様は、次のキーを持つハッシュテーブルです。

ModuleName - 必須モジュール名を指定します。
GUID - 省略可能 モジュールの GUID を指定します。
また、以下の 3 つのキーのうち少なくとも 1 つを指定Required です。
- ModuleVersion - モジュールの最小許容バージョンを指定します。
- MaximumVersion - モジュールの許容される最大バージョンを指定します。
- RequiredVersion - モジュールの正確で必要なバージョンを指定します。これは、他のバージョンキーでは使用できません。

Module パラメーターと同じコマンドで FullyQualifiedModule パラメーターを指定することはできません。 2 つのパラメーターは相互に排他的です。

型:	ModuleSpecification[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Module

Windows PowerShell スナップインとモジュール内のコマンドの指定と配列。スナップインとモジュールの名前を入力します。ワイルドカードは使用できません。

Import-PSSession では、スナップインからプロバイダーをインポートできません。

詳細については、「 about_PSSnapins と about_Modules」を参照してください。

型:	String[]
Aliases:	PSSnapin
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Prefix

インポートされたコマンドの名前の名詞のプレフィックスを指定します。

セッションに同じ名前の別のコマンドが存在する場合に発生する名前の競合を回避するには、このパラメーターを使用します。

たとえば、プレフィックス Remote を指定し、 Get-Date コマンドレットをインポートした場合、コマンドレットはセッションで Get-RemoteDateと認識され、元の Get-Date コマンドレットと混同されません。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Session

コマンドレットのインポート元となる PSSession を指定します。セッションオブジェクトを含む変数、またはセッションオブジェクトを取得するコマンド ( New-PSSession 、 Get-PSSession コマンドなど) を入力します。指定できるセッションは 1 つだけです。このパラメーターは必須です。

型:	PSSession
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

None

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

出力

PSModuleInfo

このコマンドレットは、コマンドレットが返すのと同じモジュールオブジェクトNew-ModuleGet-Module返します。ただし、インポートされたモジュールは一時的なもので、現在のセッションにのみ存在します。ディスク上に永続的なモジュールを作成するには、 Export-PSSession コマンドレットを使用します。

メモ

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

ipsn
Import-PSSession は、PowerShell リモート処理インフラストラクチャに依存しています。このコマンドレットを使用するには、WS-Management リモート処理用にコンピューターを構成する必要があります。詳細については、「 about_Remote と about_Remote_Requirements」を参照してください。
Import-PSSession では、変数または PowerShell プロバイダーはインポートされません。
現在のセッションのコマンドと同じ名前のコマンドをインポートすると、インポートされたコマンドによって、現在のセッションのエイリアス、関数、およびコマンドレットが非表示になったり、現在のセッションの関数や変数が置き換えられたりすることがあります。名前の競合を防ぐには、 Prefix パラメーターを使用します。詳細については、「about_Command_Precedence」(コマンドの優先順位について) を参照してください。
Import-PSSession は、すべてのコマンドをインポートする前に関数に変換します。そのため、インポートされたコマンドの動作は、元のコマンドの種類が維持されている場合と少し異なります。たとえば、PSSession からコマンドレットをインポートした後、モジュールまたはスナップインから同じ名前のコマンドレットをインポートした場合は、関数はコマンドレットよりも優先されるため、既定では PSSession からインポートしたコマンドレットが常に実行されます。また、同じ名前のエイリアスが存在するセッションにエイリアスをインポートした場合は、エイリアスは関数よりも優先されるため、元のエイリアスが常に使用されます。詳細については、「about_Command_Precedence」(コマンドの優先順位について) を参照してください。
Import-PSSession は、 Write-Progress コマンドレットを使用してコマンドの進行状況を表示します。コマンドが実行中の場合、進行状況バーが表示されます。
インポートするコマンドを見つけるには、 Import-PSSession Invoke-Command コマンドレットを使用して PSSession で Get-Command コマンドを実行します。コマンドの書式設定データを取得するには、 Get-FormatData コマンドレットを使用します。 Import-PSSession コマンドを実行すると、これらのコマンドレットからのエラーメッセージが表示されることがあります。また、 Import-PSSession は、 Get-Command、 Get-FormatData、 Select-Object、および Get-Help コマンドレットを含まない PSSession からコマンドをインポートすることはできません。
インポートされたコマンドには、ユーザーインターフェイスを備えたプログラム (たとえば、メモ帳) を起動できないなど、他のリモートコマンドと同じ制限があります。
Windows PowerShell プロファイルは PSSessions では実行されないため、プロファイルがセッションに追加するコマンドは、 Import-PSSessionで使用できません。プロファイルからコマンドをインポートするには、コマンドをインポートする前に、 Invoke-Command コマンドを使用して PSSession でプロファイルを手動で実行します。
Import-PSSession作成する一時モジュールには、書式設定ファイルが含まれている場合があります。コマンドで書式設定データがインポートされない場合でもです。コマンドで書式データがインポートされない場合、作成される書式ファイルに書式データは含まれません。
Import-PSSessionを使用するには、現在のセッションの実行ポリシーを Restricted または AllSigned にすることはできません。Import-PSSession作成される一時モジュールには、これらのポリシーで禁止されている署名されていないスクリプトファイルが含まれているためです。ローカルコンピューターの実行ポリシーを変更せずにImport-PSSessionを使用するには、Set-ExecutionPolicyの Scope パラメーターを使用して、1 つのプロセスに対して制限の緩い実行ポリシーを設定します。
Windows PowerShell 2.0 では、別のセッションからインポートされるコマンドのヘルプトピックには、 Prefix パラメーターを使用して割り当てたプレフィックスは含まれません。 Windows PowerShell 2.0 でインポートしたコマンドのヘルプを取得するには、元の (プレフィックスなしの) コマンド名を使用します。

Export-PSSession

次の方法で共有

Import-PSSession

構文

説明

例

例 1: PSSession からすべてのコマンドをインポートする

例 2: 特定の文字列で終わるコマンドをインポートする

例 3: PSSession からコマンドレットをインポートする

例 4: インポートされたコマンドをバックグラウンドジョブとして実行する

例 5: Windows PowerShell モジュールからコマンドレットと関数をインポートする

例 6: 一時ファイルにモジュールを作成する

例 7: インポートされたコマンドで非表示になっているコマンドを実行する

例 8: 名前に特定の文字列を含むコマンドをインポートする

例 9: Module パラメーターを使用して、セッションにインポートされたコマンドを検出する

パラメーター

-AllowClobber

-ArgumentList

-Certificate

-CommandName

-CommandType

-DisableNameChecking

-FormatTypeName

-FullyQualifiedModule

-Module

-Prefix

-Session

入力

出力

メモ

その他のリソース

次の方法で共有

Import-PSSession

構文

説明

例

例 1: PSSession からすべてのコマンドをインポートする

例 2: 特定の文字列で終わるコマンドをインポートする

例 3: PSSession からコマンドレットをインポートする

例 4: インポートされたコマンドをバックグラウンド ジョブとして実行する

例 5: Windows PowerShell モジュールからコマンドレットと関数をインポートする

例 6: 一時ファイルにモジュールを作成する

例 7: インポートされたコマンドで非表示になっているコマンドを実行する

例 8: 名前に特定の文字列を含むコマンドをインポートする

例 9: Module パラメーターを使用して、セッションにインポートされたコマンドを検出する

パラメーター

-AllowClobber

-ArgumentList

-Certificate

-CommandName

-CommandType

-DisableNameChecking

-FormatTypeName

-FullyQualifiedModule

-Module

-Prefix

-Session

入力

出力

メモ

関連リンク

その他のリソース

例 4: インポートされたコマンドをバックグラウンドジョブとして実行する