Add-Content

Add-Content
    [-Path] <string[]>
    [-Value] <Object[]>
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-NoNewline]
    [-Encoding <Encoding>]
    [-AsByteStream]
    [-Stream <string>]
    [<CommonParameters>]

Add-Content
    [-Value] <Object[]>
    -LiteralPath <string[]>
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-NoNewline]
    [-Encoding <Encoding>]
    [-AsByteStream]
    [-Stream <string>]
    [<CommonParameters>]

Add-Content cmdlet은 지정된 항목 또는 파일에 콘텐츠를 추가합니다. 콘텐츠는 파이프라인에서 전달되거나 Value 매개 변수를 사용하여 지정할 수 있습니다.

다음 예제에 대한 파일 또는 디렉터리를 만들어야 하는 경우 New-Item참조하세요.

다음은 현재 디렉터리의 텍스트 파일에 값을 추가하지만 파일 이름에 따라 파일을 제외하는 예제입니다.

Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'

Path 매개 변수는 현재 디렉터리의 모든 .txt 파일을 지정하지만 Exclude 매개 변수는 지정된 패턴과 일치하는 파일 이름을 무시합니다. Value 매개 변수는 파일에 기록되는 텍스트 문자열을 지정합니다.

콘텐츠 가져오기 사용하여 이러한 파일의 내용을 표시합니다.

다음은 현재 디렉터리의 파일에 날짜를 추가하고 PowerShell 콘솔에 날짜를 표시하는 예제입니다.

Add-Content -Path .\DateTimeFile1.log, .\DateTimeFile2.log -Value (Get-Date) -PassThru
Get-Content -Path .\DateTimeFile1.log

Tuesday, May 14, 2019 8:24:27 AM
Tuesday, May 14, 2019 8:24:27 AM
5/14/2019 8:24:27 AM

Add-Content cmdlet은 현재 디렉터리에 두 개의 새 파일을 만듭니다. Value 매개 변수에는 Get-Date cmdlet의 출력이 포함됩니다. PassThru 매개 변수는 파이프라인에 추가된 내용을 출력합니다. 출력을 받을 다른 cmdlet이 없으므로 PowerShell 콘솔에 표시됩니다. Get-Content cmdlet은 업데이트된 파일 DateTimeFile1.log표시합니다.

이 예제에서는 파일에서 콘텐츠를 가져오고 변수에 콘텐츠를 저장합니다. 변수는 콘텐츠를 다른 파일에 추가하는 데 사용됩니다.

$From = Get-Content -Path .\CopyFromFile.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txt

• Get-Content cmdlet은 CopyFromFile.txt 내용을 가져오고 내용을 $From 변수에 저장합니다.
• Add-Content cmdlet은 CopyToFile.txt 변수의 내용을 사용하여 $From 파일을 업데이트합니다.
• Get-Content cmdlet은 CopyToFile.txt표시합니다.

이 예제에서는 파일에서 콘텐츠를 가져와서 Add-Content cmdlet으로 파이프합니다.

Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txt
Get-Content -Path .\CopyToFile.txt

Get-Content cmdlet은 CopyFromFile.txt내용을 가져옵니다. Add-Content cmdlet으로 결과가 전달되어 CopyToFile.txt이 업데이트됩니다. 마지막 Get-Content cmdlet은 CopyToFile.txt표시합니다.

다음은 새 파일을 만들고 기존 파일의 콘텐츠를 새 파일에 복사하는 예제입니다.

Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\NewFile.txt

• Add-Content cmdlet은 경로 및 값 매개 변수를 사용하여 현재 디렉터리에 새 파일을 만듭니다.
• Get-Content cmdlet은 CopyFromFile.txt 기존 파일의 내용을 가져와서 Value 매개 변수에 전달합니다. Get-Content cmdlet 주위의 괄호는 Add-Content 명령이 시작되기 전에 명령이 완료되는지 확인합니다.
• Get-Content cmdlet은 NewFile.txt새 파일의 내용을 표시합니다.

이 명령은 IsReadOnly 파일 특성이 true 설정된 경우에도 파일에 값을 추가합니다. 읽기 전용 파일을 만드는 단계는 예제에 포함되어 있습니다.

New-Item -Path .\IsReadOnlyTextFile.txt -ItemType File
Set-ItemProperty -Path .\IsReadOnlyTextFile.txt -Name IsReadOnly -Value $true
Get-ChildItem -Path .\IsReadOnlyTextFile.txt
Add-Content -Path .\IsReadOnlyTextFile.txt -Value 'Add value to read-only text file' -Force
Get-Content -Path .\IsReadOnlyTextFile.txt

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-ar--         1/28/2019     13:35              0 IsReadOnlyTextFile.txt

• New-Item cmdlet은 Path 및 ItemType 매개 변수를 사용하여 현재 디렉터리에 파일 IsReadOnlyTextFile.txt 만듭니다.
• Set-ItemProperty cmdlet은 Name 및 Value 매개 변수를 사용하여 파일의 IsReadOnly 속성을 True로 변경합니다.
• Get-ChildItem cmdlet은 파일이 비어 있고(0) 읽기 전용 특성(r)을 포함합니다.
• Add-Content cmdlet은 Path 매개 변수를 사용하여 파일을 지정합니다. Value 매개 변수에는 파일에 추가할 텍스트 문자열이 포함됩니다. Force 매개 변수는 텍스트를 읽기 전용 파일에 씁니다.
• Get-Content cmdlet은 Path 매개 변수를 사용하여 파일의 내용을 표시합니다.

읽기 전용 특성을 제거하려면 Set-ItemProperty 명령을 사용하며, 값 매개 변수를 False로 설정합니다.

Add-Content cmdlet에 필터를 지정할 수 있습니다. 필터를 사용하여 Path 매개 변수를 한정하는 경우 경로의 내용을 나타내기 위해 후행 별표(*)를 포함해야 합니다.

다음 명령은 *.txt 디렉터리에 있는 모든 C:\Temp 파일의 내용을 "완료"라는 단어를 추가합니다.

Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"

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

값을 Add-Content으로 전달할 수 있습니다.

자격 증명을 Add-Content로 전달할 수 있습니다.

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

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 콘텐츠를 나타내는 System.String 개체를 반환합니다.

PowerShell에는 Add-Content에 대한 다음과 같은 별칭들이 포함되어 있습니다.

• Windows:

  • ac

• 개체를 Add-Content파이프하면 개체가 항목에 추가되기 전에 문자열로 변환됩니다. 개체 형식은 문자열 형식을 결정하지만 형식은 개체의 기본 표시와 다를 수 있습니다. 문자열 형식을 제어하려면 보내는 cmdlet의 서식 매개 변수를 사용합니다.

• Add-Content cmdlet은 모든 공급자가 노출하는 데이터를 사용하도록 설계되었습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 Get-PSProvider입력합니다. 추가 정보는 about_Providers를 참조하십시오.