다음을 통해 공유

Add-History

  • 참조
모듈:
Microsoft.PowerShell.Core

세션 기록에 항목을 추가합니다.

구문

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

Description

Add-History cmdlet은 세션 기록의 끝에 항목을 추가합니다. 즉, 현재 세션 중에 입력된 명령 목록입니다.

세션 기록은 세션 중에 입력된 명령 목록입니다. 세션 기록은 명령의 실행 순서, 상태 및 시작 및 종료 시간을 나타냅니다. 각 명령을 입력할 때 PowerShell은 다시 사용할 수 있도록 기록에 추가합니다. 세션 기록에 대한 자세한 내용은 about_History참조하세요.

세션 기록은 PSReadLine 모듈에서 유지 관리하는 기록과 별도로 관리됩니다. 두 기록은 PSReadLine 로드되는 세션에서 사용할 수 있습니다. 이 cmdlet은 세션 기록에서만 작동합니다. 자세한 내용은 about_PSReadLine에서 확인하세요.

Get-History cmdlet을 사용하여 명령을 가져와 Add-History전달하거나, CSV 또는 XML 파일로 명령을 내보낸 다음, 명령을 가져온 다음 가져온 파일을 Add-History전달할 수 있습니다. 이 cmdlet을 사용하여 기록에 특정 명령을 추가하거나 둘 이상의 세션의 명령을 포함하는 단일 기록 파일을 만들 수 있습니다.

예제

예제 1: 다른 세션의 기록에 명령 추가

다음은 한 PowerShell 세션에 입력된 명령을 다른 PowerShell 세션의 기록에 추가하는 예제입니다.

Get-History | Export-Csv -Path C:\testing\history.csv -IncludeTypeInformation
Import-Csv -Path C:\testing\history.csv | Add-History

첫 번째 명령은 기록의 명령을 나타내는 개체를 가져오고 History.csv 파일로 내보냅니다.

두 번째 명령은 다른 세션의 명령줄에 입력됩니다. Import-Csv cmdlet을 사용하여 History.csv 파일의 개체를 가져옵니다. 파이프라인 연산자(|)는 개체를 Add-History cmdlet에 전달하여 History.csv 파일의 명령을 나타내는 개체를 현재 세션 기록에 추가합니다.

예제 2: 명령 가져오기 및 실행

다음은 History.xml 파일에서 명령을 가져와 현재 세션 기록에 추가한 다음 결합된 기록에서 명령을 실행하는 예제입니다.

Import-Clixml -Path C:\temp\history.xml | Add-History -PassThru | ForEach-Object -Process {Invoke-History}

첫 번째 명령은 Import-Clixml cmdlet을 사용하여 History.xml 파일로 내보낸 명령 기록을 가져옵니다. 파이프라인 연산자는 현재 세션 기록에 명령을 추가하는 Add-History cmdlet에 명령을 전달합니다. PassThru 매개 변수는 추가된 명령을 나타내는 개체를 파이프라인 아래로 전달합니다.

그런 다음 이 명령은 ForEach-Object cmdlet을 사용하여 결합된 기록의 각 명령에 Invoke-History 명령을 적용합니다. Invoke-History 명령은 {} cmdlet의 Process 매개 변수에 필요한 대로 중괄호(ForEach-Object)로 묶은 스크립트 블록으로 형식이 지정됩니다.

예제 3: 명령을 기록의 끝에 추가하기

다음은 기록 목록의 끝에 기록의 처음 5개 명령을 추가하는 예제입니다.

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

Get-History cmdlet은 명령 5로 끝나는 5개의 명령을 가져옵니다. 파이프라인 연산자는 그것들을 Add-History cmdlet에 전달하며, 이는 그것들을 현재 기록에 추가합니다. Add-History 명령에는 매개 변수가 포함되지 않지만 PowerShell은 파이프라인을 통해 전달된 개체를 Add-History 매개 변수와 연결합니다.

예제 4: 현재 기록에 .csv 파일의 명령 추가

다음은 History.csv 파일의 명령을 현재 세션 기록에 추가하는 예제입니다.

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

Import-Csv cmdlet은 History.csv 파일의 명령을 가져오고 해당 내용을 변수 $a저장합니다.

두 번째 명령은 Add-History cmdlet을 사용하여 History.csv 명령을 현재 세션 기록에 추가합니다. InputObject 매개 변수를 사용하여 $a 변수와 PassThru 매개 변수를 지정하여 명령줄에 표시할 개체를 생성합니다. PassThru 매개 변수가 없으면 Add-History cmdlet은 출력을 생성하지 않습니다.

예제 5: 현재 기록에 .xml 파일의 명령 추가

다음은 history.xml 파일의 명령을 현재 세션 기록에 추가하는 예제입니다.

Add-History -InputObject (Import-Clixml -Path C:\temp\history.xml)

InputObject 매개 변수는 명령의 결과를 괄호 안에 Add-History cmdlet에 전달합니다. 먼저 실행되는 괄호 안의 명령은 history.xml 파일을 PowerShell로 가져옵니다. 그런 다음 Add-History cmdlet은 파일의 명령을 세션 기록에 추가합니다.

매개 변수

-InputObject

기록에 추가할 항목 배열을 세션 기록에 HistoryInfo 개체로 지정합니다. 이 매개 변수를 사용하여 , Get-History또는 Import-Clixml cmdlet에서 반환된 개체와 같은 Import-Csv 개체를 Add-History제출할 수 있습니다.

형식:PSObject[]
Position:0
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PassThru

이 cmdlet은 각 기록 항목에 대한 HistoryInfo 개체를 반환한다는 것을 나타냅니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

HistoryInfo

이 cmdlet으로 HistoryInfo 개체를 파이프할 수 있습니다.

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

HistoryInfo

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 HistoryInfo 개체를 반환합니다.

참고

세션 기록은 ID와 함께 세션 중에 입력된 명령 목록입니다. 세션 기록은 명령의 실행 순서, 상태 및 시작 및 종료 시간을 나타냅니다. 각 명령을 입력할 때 PowerShell은 다시 사용할 수 있도록 기록에 추가합니다. 세션 기록에 대한 자세한 내용은 about_History참조하세요.

기록에 추가할 명령을 지정하려면 InputObject 매개 변수를 사용합니다. Add-History 명령은 cmdlet에서 각 명령에 대해 반환되는 개체와 같은 Get-History 개체만 허용합니다. 경로 및 파일 이름 또는 명령 목록을 전달할 수 없습니다.

InputObject 매개 변수를 사용하여 HistoryInfo 개체로 구성된 파일을 Add-History에 전달할 수 있습니다. 이렇게 하려면 Get-History 또는 Export-Csv cmdlet을 사용하여 Export-Clixml 명령의 결과를 파일로 내보낸 다음 Import-Csv 또는 Import-Clixml cmdlet을 사용하여 파일을 가져옵니다. 그런 다음 가져온 HistoryInfo 개체의 파일을 파이프라인이나 변수에 Add-History 전달할 수 있습니다. 자세한 내용은 예제를 참조하세요.

cmdlet에 전달하는 Add-History 개체의 파일에는 형식 정보, 열 머리글 및 HistoryInfo 개체의 모든 속성이 포함되어야 합니다. 개체를 다시 Add-History전달하려는 경우 cmdlet의 Export-Csv 매개 변수를 사용하지 않고 파일의 형식 정보, 열 머리글 또는 필드를 삭제하지 마세요.

세션 기록을 수정하려면 세션을 CSV 또는 XML 파일로 내보내고, 파일을 수정하고, 파일을 가져오고, Add-History 사용하여 현재 세션 기록에 추가합니다.