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 から現在のセッションにインポートします。コマンドレットが PSSession で検索できる任意のコマンド Get-Command をインポートできます。

コマンドを 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 使用して、PSSession から現在のセッションに $S コマンドをインポートします。 CommandName パラメーターを使用して、Test 名詞と FormatTypeName パラメーターを使用してコマンドを指定し、テストコマンドの書式設定データをインポートします。

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

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

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

別々の 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 番目のコマンドは、PSSession から現在のセッションに $S Test コマンドレットをインポートするために使用Import-PSSessionします。

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使用して PSSession $Sでコマンドを実行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 使用して、コマンドレットと SearchHelp 関数を現在のセッションにインポート Get-Date します。

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

例 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

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

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

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

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

このコマンドは、PSSession $Sの 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

このコマンドは、Module パラメーターGet-Commandを使用して、コマンドによってセッションにインポートされたコマンドを確認する方法を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 現在のセッションのコマンドと同じ名前のコマンドはインポートされません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ArgumentList

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

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

Type:	Object[]
Aliases:	Args
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Certificate

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

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

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

Type:	X509Certificate2
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CommandName

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

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

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

Type:	String[]
Aliases:	Name
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CommandType

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

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

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

Type:	CommandTypes
Aliases:	Type
Accepted values:	Alias, Function, Filter, Cmdlet, ExternalScript, Application, Script, Workflow, Configuration, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableNameChecking

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

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

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FormatTypeName

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

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

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

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

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

Type:	String[]
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FullyQualifiedModule

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

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

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

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

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

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

Type:	ModuleSpecification[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Module

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

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

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

Type:	String[]
Aliases:	PSSnapin
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Prefix

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

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Session

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

Type:	PSSession
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

入力

None

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

出力

PSModuleInfo

このコマンドレットは、コマンドレットが返すのとGet-Module同じモジュールオブジェクトNew-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およびコマンドレットを含まない PSSession からコマンドをSelect-ObjectGet-CommandGet-FormatDataGet-Helpインポートすることはできません。
インポートされたコマンドには、ユーザーインターフェイスを備えたプログラム (たとえば、メモ帳) を起動できないなど、他のリモートコマンドと同じ制限があります。
Windows PowerShell プロファイルは PSSessions では実行されないため、プロファイルがセッションに追加するコマンドは使用できません Import-PSSession。プロファイルからコマンドをインポートするには、コマンドをインポートする前に、コマンドを Invoke-Command 使用して PSSession でプロファイルを手動で実行します。
作成する Import-PSSession 一時モジュールには、書式設定ファイルが含まれている場合があります。このコマンドで書式設定データがインポートされない場合でも、コマンドで書式データがインポートされない場合、作成される書式ファイルに書式データは含まれません。
作成 Import-PSSessionする一時モジュール Import-PSSession には、これらのポリシーで禁止されている署名されていないスクリプトファイルが含まれているため、現在のセッションの実行ポリシーを Restricted または AllSigned にすることはできません。ローカルコンピューターの実行ポリシーを変更せずに使用Import-PSSessionするには、Scope パラメーターを使用して、1 つのプロセスに対して制限のSet-ExecutionPolicy緩い実行ポリシーを設定します。
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: インポートされたコマンドをバックグラウンドジョブとして実行する