次の方法で共有

Add-History

  • リファレンス
モジュール:
Microsoft.PowerShell.Core

セッションの履歴にエントリを追加します。

構文

Add-History
   [[-InputObject] <PSObject[]>]
   [-Passthru]
   [<CommonParameters>]

説明

コマンドレットは Add-History 、セッション履歴の最後にエントリを追加します。つまり、現在のセッション中に入力されたコマンドの一覧です。 コマンドレットを Get-History 使用すると、コマンドを取得して に Add-History渡すことができます。または、コマンドを CSV または XML ファイルにエクスポートしてから、コマンドをインポートして、インポートしたファイルを に Add-History渡すことができます。 このコマンドレットを使用して、履歴に特定のコマンドを追加するか、または複数のセッションからのコマンドを含む 1 つの履歴ファイルを作成できます。

例

例 1: 別のセッションの履歴にコマンドを追加する

# Get objects representing the commands in the history and exports them to the History.csv file.
Get-History | Export-Csv c:\testing\history.csv
# Use the `Import-Csv` cmdlet to import the objects in the History.csv file.
Import-Csv history.csv | Add-History

これらのコマンドは、1 つの Windows PowerShell セッションで入力したコマンドを別の Windows PowerShell セッションの履歴に追加します。 2 番目のコマンドは、別のセッションのコマンド ラインで入力します。

パイプライン演算子 | は、オブジェクトを コマンドレットに Add-History 渡します。これにより、History.csv ファイル内のコマンドを表すオブジェクトが現在のセッション履歴に追加されます。

例 2: コマンドのインポートと実行

Import-Clixml c:\temp\history.xml | Add-History -Passthru | ForEach-Object -Process {Invoke-History}

このコマンドは、History.xml ファイルからコマンドをインポートし、それらを現在のセッション履歴に追加してから、結合された履歴でコマンドを実行します。

コマンドレットは Import-Clixml 、History.xml ファイルにエクスポートされたコマンド履歴をインポートします。

パイプライン演算子は、 コマンドレットにコマンドを Add-History 渡します。これにより、コマンドが現在のセッション履歴に追加されます。

PassThru パラメーターは、追加されたコマンドを表すオブジェクトをパイプラインに渡します。

を使用する コマンドレットは ForEach-Object 、結合された Invoke-History 履歴内の各コマンドにコマンドを適用します。

コマンドは Invoke-History スクリプト ブロックとして書式設定され、コマンドレットの Process パラメーター ForEach-Object で必要に応じて中かっこで囲まれます。

例 3: 履歴の末尾にコマンドを追加する

Get-History -Id 5 -Count 5 | Add-History

このコマンドでは、履歴一覧の最後に履歴の最初の 5 つのコマンドを追加します。 コマンドレットを Get-History 使用して、コマンド 5 で終わる 5 つのコマンドを取得します。 パイプライン演算子は、それらをコマンドレットに Add-History 渡し、現在の履歴に追加します。

コマンドにはAdd-Historyパラメーターは含まれませんが、Windows PowerShellパイプラインを介して渡されたオブジェクトを の InputObject パラメーターAdd-Historyに関連付けます。

例 4: .csv ファイル内のコマンドを現在の履歴に追加する

$a = Import-Csv c:\testing\history.csv
Add-History -InputObject $a -PassThru

これらのコマンドは、History.csv ファイル内のコマンドを現在のセッションの履歴に追加します。

最初のコマンドでは、 コマンドレットを Import-Csv 使用してコマンドを History.csv ファイルにインポートし、その内容を 変数 $aに格納します。

2 番目のコマンドでは、 コマンドレットを Add-History 使用して、History.csv から現在のセッション履歴にコマンドを追加します。

このコマンドレットは、$a 変数を指定する InputObject パラメーターおよびコマンド ラインに表示するオブジェクトを生成する PassThru パラメーターを指定します。 PassThru パラメーターがない場合、Add-Historyコマンドレットは出力を生成しません。

例 5: .xml ファイル内のコマンドを現在の履歴に追加する

Add-History -InputObject (Import-Clixml c:\temp\history01.xml)

このコマンドは、History01.xml ファイル内のコマンドを現在のセッションの履歴に追加します。 InputObject パラメーターを使用して、コマンドの結果をかっこで囲んで コマンドレットにAdd-History渡します。

かっこで囲まれたコマンドは最初に実行されて、Windows PowerShell に History01.xml ファイルをインポートします。 次に、 コマンドレットによって Add-History 、ファイル内のコマンドがセッション履歴に追加されます。

パラメーター

-InputObject

履歴に追加するエントリの配列を、セッション履歴に HistoryInfo オブジェクトとして指定します。 このパラメーターを使用すると、、Import-Clixml、または Import-Csv コマンドレットによってGet-History返されるなど、HistoryInfo オブジェクトを にAdd-History送信できます。

Type:PSObject[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Passthru

このコマンドレットは、各履歴エントリの履歴オブジェクトを返します。 既定では、このコマンドレットによる出力はありません。

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

入力

HistoryInfo

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

出力

None or Microsoft.PowerShell.Commands.HistoryInfo

PassThru パラメーターを指定すると、このコマンドレットは HistoryInfo オブジェクトを返します。 それ以外の場合、このコマンドレットによる出力はありません。

メモ

  • セッション履歴は、セッション中に入力されたコマンドと ID の一覧です。 セッション履歴は、実行の順序、状態、コマンドの開始時刻と終了時刻を表します。 コマンドを入力すると、再利用できるように Windows PowerShell によってコマンドが履歴に追加されます。 セッション履歴の詳細については、「 about_History」を参照してください。

  • 履歴に追加するコマンドを指定するには、InputObject パラメーターを使用します。 コマンドはAdd-History、コマンドレットによってGet-Historyコマンドごとに返されるなど、HistoryInfo オブジェクトのみを受け入れます。 パスとファイル名、またはコマンドの一覧を渡すことはできません。

  • InputObject パラメーターを使用して、HistoryInfo オブジェクトのファイルを にAdd-History渡すことができます。 これを行うには、 または コマンドレットをGet-History使用Export-Csvしてコマンドの結果をファイルにエクスポートし、 または Export-Clixml コマンドレットを使用してファイルをImport-CsvImport-Clixmlインポートします。 その後、インポートした HistoryInfo オブジェクトのファイルを Add-History パイプラインまたは変数に渡すことができます。 詳細については、例を参照してください。

  • コマンドレットにAdd-History渡す HistoryInfo オブジェクトのファイルには、種類情報、列見出し、および HistoryInfo オブジェクトのすべてのプロパティを含める必要があります。 オブジェクトを に Add-History渡す場合は、コマンドレットの NoTypeInformation パラメーターを Export-Csv 使用しないでください。また、型情報、列見出し、またはファイル内のフィールドは削除しないでください。 セッション履歴を変更するには、セッションを CSV または XML ファイルにエクスポートし、ファイルを変更し、ファイルをインポートして、それを使用 Add-History して現在のセッション履歴に追加します。