Add-Content

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

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

Add-Content cmdlet은 지정된 항목 또는 파일에 콘텐츠를 추가합니다. 명령에 내용을 입력하거나 내용이 포함된 개체를 지정하여 내용을 지정할 수 있습니다.

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

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

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

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

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

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

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

cmdlet은 Add-ContentPath 및 Value 매개 변수를 사용하여 현재 디렉터리에 두 개의 새 파일을 만듭니다. Value 매개 변수는 날짜를 가져올 cmdlet을 Get-Date 지정하고 날짜를 Add-Content에 전달합니다. cmdlet은 Add-Content 각 파일에 날짜를 씁니다. PassThru 매개 변수는 날짜 개체를 나타내는 개체를 전달합니다. 전달된 개체를 받을 다른 cmdlet이 없기 때문에 PowerShell 콘솔에 표시됩니다. cmdlet은 Get-Content 업데이트된 파일 DateTimeFile1.log를 표시합니다.

이 예제에서는 파일에서 콘텐츠를 가져와 해당 콘텐츠를 다른 파일에 추가합니다.

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

cmdlet은 Add-ContentPath 매개 변수를 사용하여 현재 디렉터리의 새 파일 CopyToFile.txt지정합니다. Value 매개 변수는 cmdlet을 Get-Content 사용하여 파일 CopyFromFile.txt. Get-Content cmdlet 주위의 괄호는 Add-Content 명령이 시작되기 전에 명령이 완료되는지 확인합니다. Value 매개변수는 에 전달됩니다Add-Content. cmdlet은 Add-Content CopyToFile.txt 파일에 데이터를 추가합니다. cmdlet은 Get-Content 업데이트된 파일 CopyToFile.txt표시합니다.

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

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

cmdlet은 Get-Content CopyFromFile.txt의 내용을 가져와서 변수에 저장합니다 $From . cmdlet은 Add-ContentPath 매개 변수를 사용하여 현재 디렉터리의 CopyToFile.txt 파일을 지정합니다. Value 매개 변수는 변수를 $From 사용하여 내용을 Add-Content에 전달합니다. cmdlet이 Add-Content 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은 경로 및 값 매개 변수를 사용하여 현재 디렉터리에 새 파일을 만듭니다. Value 매개 변수는 cmdlet을 Get-Content 사용하여 기존 파일 CopyFromFile.txt. Get-Content cmdlet 주위의 괄호는 Add-Content 명령이 시작되기 전에 명령이 완료되는지 확인합니다. Value 매개 변수는 NewFile.txt 파일을 업데이트하는 콘텐츠를 Add-Content 전달합니다. cmdlet은 Get-Content 새 파일 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

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

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

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

값, 경로 또는 자격 증명을 로 파이프할 Set-Content수 있습니다.

PassThru 매개 변수를 사용하면 Add-Content 콘텐츠를 나타내는 System.String 개체를 생성합니다. 그렇지 않으면 이 cmdlet은 출력을 생성하지 않습니다.

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

기본 제공 별칭인 Add-Contentac 참조할 수도 있습니다. 자세한 내용은 about_Aliases참조하세요.

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