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

구문

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

설명

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

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

매개 변수

-InputObject <PSObject[]>

지정된 HistoryInfo 개체를 세션 기록에 추가합니다. 이 매개 변수를 사용하여 HistoryInfo 개체를 Get-History, Import-Clixml 또는 Import-Csv에서 Add-History로 전송할 수 있습니다.

필수 여부

false

위치

1

기본값

파이프라인 입력 적용 여부

true (ByValue)

와일드카드 문자 적용 여부

false

-PassThru

각 기록 항목의 기록 개체를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

Microsoft.PowerShell.Commands.HistoryInfo

HistoryInfo 개체를 Add-History로 파이프할 수 있습니다.

출력

없음 또는 Microsoft.PowerShell.Commands.HistoryInfo

PassThru 매개 변수를 사용할 경우 Add-History는 HistoryInfo 개체를 생성합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다.

참고

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

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

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

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

세션 기록을 편집하려면 세션을 CSV 또는 XML 파일로 내보내고 파일을 편집한 다음 해당 파일을 가져와서 Add-History를 통해 현재 세션 기록에 추가합니다.

예 1

C:\PS>get-history | export-csv c:\testing\history.csv

C:\PS>import-csv history.csv | add-history

설명
-----------
이들 명령은 Windows PowerShell 세션에 입력된 명령을 다른 Windows PowerShell 세션의 기록에 추가합니다. 첫 번째 명령은 기록에서 명령을 나타내는 개체를 가져와서 History.csv 파일로 내보냅니다. 두 번째 명령은 다른 세션의 명령줄에 입력합니다. 이 명령은 Import-Csv cmdlet을 사용하여 History.csv 파일의 개체를 가져옵니다. 파이프라인 연산자는 개체를 Add-History cmdlet으로 전달합니다. 이 cmdlet은 History.csv 파일에서 명령을 나타내는 개체를 현재 세션 기록에 추가합니다.






예 2

C:\PS>import-clixml c:\temp\history.xml | add-history -passthru | foreach-object {invoke-history}

설명
-----------
이 명령은 History.xml 파일에서 명령을 가져와 현재 세션 기록에 추가한 다음 결합된 기록의 명령을 실행합니다. 

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

그런 다음 이 명령은 ForEach-Object cmdlet을 사용하여 Invoke-History 명령을 결합된 기록의 각 명령에 적용합니다. 적용할 명령이 하나뿐인 경우에도 ForEach-Object에는 스크립트 블록이 필요하기 때문에 Invoke-History 명령의 형식은 스크립트 블록으로 지정되어 중괄호({})로 묶입니다.






예 3

C:\PS>get-history -id 5 -count 5 | add-history

설명
-----------
이 명령은 기록의 처음 5개 명령을 기록 목록의 끝에 추가합니다. 먼저 Get-History cmdlet을 사용하여 command 5로 끝나는 5개 명령을 가져옵니다. 파이프라인 연산자(|)는 이러한 명령을 Add-History cmdlet으로 전달하고 해당 cmdlet은 다시 이 명령을 현재 기록에 추가합니다. Add-History 명령에는 매개 변수가 없지만 Windows PowerShell은 파이프라인을 통해 전달된 개체를 InputObject 매개 변수와 연결합니다.






예 4

C:\PS>$a = import-csv c:\testing\history.csv

C:\PS>add-history -inputobject $a -passthru

설명
-----------
이들 명령은 History.csv 파일의 명령을 현재 세션 기록에 추가합니다. 첫 번째 명령은 Import-Csv cmdlet을 사용하여 History.csv 파일의 명령을 가져와서 해당 내용을 $a 변수에 저장합니다. 두 번째 명령은 Add-History cmdlet을 사용하여 History.csv의 명령을 현재 세션 기록에 추가합니다. 이 명령은 InputObject 매개 변수를 사용하여 $a 변수를 지정하고 PassThru 매개 변수를 사용하여 명령줄에 표시할 개체를 생성합니다. PassThru 매개 변수가 없으면 Add-History가 표시할 출력을 생성하지 않습니다.






예 5

C:\PS>add-history -inputobject (import-clixml c:\temp\history01.xml)

설명
-----------
이 명령은 History01.xml 파일의 명령을 현재 세션 기록에 추가합니다. 먼저 InputObject 매개 변수를 사용하여 괄호로 묶인 명령의 결과를 Add-History로 전달합니다. 그러면 괄호 안의 명령이 실행되어 History01.xml 파일을 Windows PowerShell로 가져옵니다. Add-History는 파일의 명령을 세션 기록에 추가합니다.






참고 항목




목차