Out-File

모듈:: Microsoft.PowerShell.Utility Module

출력을 파일로 보냅니다.

구문

ByPath (기본값)

Out-File
    [-FilePath] <string>
    [[-Encoding] <string>]
    [-Append]
    [-Force]
    [-NoClobber]
    [-Width <int>]
    [-NoNewline]
    [-InputObject <psobject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByLiteralPath

Out-File
    [[-Encoding] <string>]
    -LiteralPath <string>
    [-Append]
    [-Force]
    [-NoClobber]
    [-Width <int>]
    [-NoNewline]
    [-InputObject <psobject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Out-File cmdlet은 출력을 파일로 보냅니다. 출력에 대한 매개 변수를 지정해야 하는 경우 리디렉션 연산자()Out-File 대신 사용합니다>.

예제

예제 1: 출력 보내기 및 파일 만들기

이 예제에서는 로컬 컴퓨터의 프로세스 목록을 파일로 보내는 방법을 보여줍니다. 파일이 없으면 Out-File 지정된 경로에 파일을 만듭니다.

Get-Process | Out-File -FilePath .\Process.txt
Get-Content -Path .\Process.txt

 NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     29    22.39      35.40      10.98   42764   9 Application
     53    99.04     113.96       0.00   32664   0 CcmExec
     27    96.62     112.43     113.00   17720   9 Code

Get-Process cmdlet은 로컬 컴퓨터에서 실행되는 프로세스 목록을 가져옵니다. Process 개체는 파이프라인을 Out-File cmdlet으로 보냅니다. Out-File FilePath 매개 변수를 사용하고 Process.txt현재 디렉터리에 파일을 만듭니다. Get-Content 명령은 파일에서 콘텐츠를 가져와 PowerShell 콘솔에 표시합니다.

예제 2: 기존 파일을 덮어쓰지 않도록 방지

이 예제에서는 기존 파일을 덮어쓰지 않도록 합니다. 기본적으로 Out-File 기존 파일을 덮어씁니다.

Get-Process | Out-File -FilePath .\Process.txt -NoClobber

Out-File : The file 'C:\Test\Process.txt' already exists.
At line:1 char:15
+ Get-Process | Out-File -FilePath .\Process.txt -NoClobber
+               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Get-Process cmdlet은 로컬 컴퓨터에서 실행되는 프로세스 목록을 가져옵니다. Process 개체는 파이프라인을 Out-File cmdlet으로 보냅니다. Out-File FilePath 매개 변수를 사용하고 Process.txt현재 디렉터리의 파일에 쓰려고 시도합니다. NoClobber 매개 변수는 파일을 덮어쓰지 못하게 하고 파일이 이미 있다는 메시지를 표시합니다.

예제 3: ASCII 형식의 파일에 출력 보내기

이 예제에서는 특정 인코딩 형식으로 출력을 인코딩하는 방법을 보여줍니다.

$Procs = Get-Process
Out-File -FilePath .\Process.txt -InputObject $Procs -Encoding ASCII -Width 50

Get-Process cmdlet은 로컬 컴퓨터에서 실행되는 프로세스 목록을 가져옵니다. Process 개체는 변수 $Procs저장됩니다. Out-File FilePath 매개 변수를 사용하고 Process.txt현재 디렉터리에 파일을 만듭니다. InputObject 매개 변수는 $Procs 프로세스 개체를 파일 Process.txt전달합니다. 인코딩 매개 변수는 출력을 ASCII 형식으로 변환합니다. Width 매개 변수는 일부 데이터가 잘리도록 파일의 각 줄을 50자로 제한합니다.

예제 4: 공급자 사용 및 파일로 출력 보내기

이 예제에서는 Out-File 공급자 드라이브에 있지 않을 때 cmdlet을 사용하는 방법을 보여 줍니다. Get-PSProvider cmdlet을 사용하여 로컬 컴퓨터에서 공급자를 봅니다. 추가 정보는 about_Providers를 참조하십시오.

PS> Set-Location -Path Alias:

PS> Get-Location

Path
----
Alias:\

PS> Get-ChildItem | Out-File -FilePath C:\TestDir\AliasNames.txt

PS> Get-Content -Path C:\TestDir\AliasNames.txt

CommandType     Name
-----------     ----
Alias           % -> ForEach-Object
Alias           ? -> Where-Object
Alias           ac -> Add-Content
Alias           cat -> Get-Content

Set-Location 명령은 Path 매개 변수를 사용하여 현재 위치를 레지스트리 공급자 Alias:설정합니다. Get-Location cmdlet은 Alias:대한 전체 경로를 표시합니다. Get-ChildItem 파이프라인 아래로 개체를 Out-File cmdlet으로 보냅니다. Out-File FilePath 매개 변수를 사용하여 출력에 대한 전체 경로 및 파일 이름을 지정합니다. C:\TestDir\AliasNames.txt. Get-Content cmdlet은 Path 매개 변수를 사용하고 PowerShell 콘솔에 파일의 콘텐츠를 표시합니다.

매개 변수

-Append

기존 파일의 끝에 출력을 추가합니다. 인코딩을 지정하지 않으면 cmdlet은 기본 인코딩을 사용합니다. 이 인코딩은 대상 파일의 인코딩과 일치하지 않을 수 있습니다. 리디렉션 연산자(>>)와 동일한 동작입니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	cf(cf)

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Encoding

대상 파일의 인코딩 형식을 지정합니다. 기본값은 유니코드.

이 매개 변수에 허용되는 값은 다음과 같습니다.

ASCII ASCII(7비트) 문자 집합을 사용합니다.
BigEndianUnicode big-endian 바이트 순서로 UTF-16을 사용합니다.
기본 시스템의 활성 코드 페이지(일반적으로 ANSI)에 해당하는 인코딩을 사용합니다.
OEM 시스템의 현재 OEM 코드 페이지에 해당하는 인코딩을 사용합니다.
문자열 유니코드동일합니다.
유니코드 little-endian 바이트 순서로 UTF-16을 사용합니다.
알 수 없는 유니코드동일합니다.
UTF7 UTF-7을 사용합니다.
UTF8 UTF-8을 사용합니다.
UTF32 little-endian 바이트 순서로 UTF-32를 사용합니다.

매개 변수 속성

형식:	String
Default value:	Unicode
허용되는 값:	ASCII, BigEndianUnicode, Default, OEM, String, Unicode, Unknown, UTF7, UTF8, UTF32
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	1
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-FilePath

출력 파일의 경로를 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ByPath

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Force

읽기 전용 특성을 재정의하고 기존 읽기 전용 파일을 덮어씁니다. Force 매개 변수는 보안 제한을 재정의하지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-InputObject

파일에 쓸 개체를 지정합니다. 개체를 포함하는 변수를 입력하거나 개체를 가져오는 명령이나 식을 입력합니다.

매개 변수 속성

형식:	PSObject
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-LiteralPath

출력 파일의 경로를 지정합니다. LiteralPath 매개 변수는 입력된 그대로 사용됩니다. 와일드 카드 문자 허용 되지 않습니다. 경로에 이스케이프 문자가 포함된 경우 작은따옴표로 묶습니다. 작은따옴표는 PowerShell에 문자를 이스케이프 시퀀스로 해석하지 않도록 지시합니다. 자세한 내용은 about_Quoting_Rules참조하세요.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	PSPath

매개 변수 집합

ByLiteralPath

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-NoClobber

NoClobber 기존 파일을 덮어쓰지 못하게 하고 파일이 이미 있다는 메시지를 표시합니다. 기본적으로 지정된 경로에 파일이 있는 경우 Out-File 경고 없이 파일을 덮어씁니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	NoOverwrite

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-NoNewline

파일에 쓰여진 내용이 줄 바꿈 문자로 끝나지 않도록 지정합니다. 입력 개체의 문자열 표현은 출력을 형성하기 위해 연결됩니다. 출력 문자열 사이에 공백이나 줄 바꿈이 삽입되지 않습니다. 마지막 출력 문자열 이후에 줄 바꿈이 추가되지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	위스콘신

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Width

각 출력 줄의 문자 수를 지정합니다. 추가 문자는 래핑되지 않고 잘립니다. 이 매개 변수를 사용하지 않으면 너비는 호스트의 특성에 따라 결정됩니다. PowerShell 콘솔의 기본값은 80자입니다.

매개 변수 속성

형식:	Int
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

PSObject

모든 개체를 Out-File파이프할 수 있습니다.

출력

None

Out-File 출력을 생성하지 않습니다.

참고

cmdlet은 Out 개체의 서식을 지정하지 않고 단순히 렌더링하여 지정된 표시 대상으로 보냅니다. 형식이 지정되지 않은 개체를 Out cmdlet에 보내는 경우 cmdlet은 렌더링하기 전에 서식 cmdlet으로 보냅니다.

powerShell 명령의 출력을 Out-File cmdlet으로 보내려면 파이프라인을 사용합니다. 변수에 데이터를 저장하고 InputObject 매개 변수를 사용하여 cmdlet에 데이터를 전달할 수 있습니다 Out-File .

Out-File 데이터를 전송하지만 출력 개체를 생성하지 않습니다. 의 Out-File 출력을 로 Get-Member파이프하면 cmdlet은 Get-Member 개체가 지정되지 않았다고 보고합니다.

다음을 통해 공유

Out-File

구문

ByPath (기본값)

ByLiteralPath

Description

예제

예제 1: 출력 보내기 및 파일 만들기

예제 2: 기존 파일을 덮어쓰지 않도록 방지

예제 3: ASCII 형식의 파일에 출력 보내기

예제 4: 공급자 사용 및 파일로 출력 보내기

매개 변수

-Append

매개 변수 속성

매개 변수 집합

-Confirm

매개 변수 속성

매개 변수 집합

-Encoding

매개 변수 속성

매개 변수 집합

-FilePath

매개 변수 속성

매개 변수 집합

-Force

매개 변수 속성

매개 변수 집합

-InputObject

매개 변수 속성

매개 변수 집합

-LiteralPath

매개 변수 속성

매개 변수 집합

-NoClobber

매개 변수 속성

매개 변수 집합

-NoNewline

매개 변수 속성

매개 변수 집합

-WhatIf

매개 변수 속성

매개 변수 집합

-Width

매개 변수 속성

매개 변수 집합

CommonParameters

입력

PSObject

출력

None

참고

관련 링크