New-Item

구문

New-Item
   [-Path] <string[]>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

New-Item
   [[-Path] <string[]>]
   -Name <string>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

New-Item
   [-Path] <string[]>
   -ConnectionURI <uri>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-OptionSet <hashtable>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <string>]
   [-SessionOption <SessionOption>]
   [-Port <int>]
   [<CommonParameters>]

New-Item
   [[-Path] <string[]>]
   -Name <string>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-OptionSet <hashtable>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <string>]
   [-SessionOption <SessionOption>]
   [-ApplicationName <string>]
   [-Port <int>]
   [-UseSSL]
   [<CommonParameters>]

New-Item
   [-Path] <string[]>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-Options <ScopedItemOptions>]
   [<CommonParameters>]

New-Item
   [[-Path] <string[]>]
   -Name <string>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-Options <ScopedItemOptions>]
   [<CommonParameters>]

Description

cmdlet은 New-Item 새 항목을 만들고 해당 값을 설정합니다. 만들 수 있는 항목의 형식은 항목의 위치에 따라 달라집니다. 예를 들어 파일 시스템에서 New-Item 파일 및 폴더를 만듭니다. 레지스트리 New-Item 에서 레지스트리 키 및 항목을 만듭니다.

New-Item 는 만든 항목의 값을 설정할 수도 있습니다. 예를 들어 새 파일을 만들 때 파일에 New-Item 초기 콘텐츠를 추가할 수 있습니다.

예제

예제 1: 현재 디렉터리에 파일 만들기

이 명령은 현재 디렉터리에 "testfile1.txt"이라는 텍스트 파일을 만듭니다. Path 매개 변수 값의 점('.')은 현재 디렉터리를 나타냅니다. Value 매개 변수 뒤에 있는 따옴표 붙은 텍스트가 파일에 콘텐츠로 추가됩니다.

New-Item -Path . -Name "testfile1.txt" -ItemType "file" -Value "This is a text string."

예제 2: 디렉터리 만들기

이 명령은 드라이브에 "Logfiles" C: 라는 디렉터리를 만듭니다. ItemType 매개 변수는 새 항목이 파일 또는 다른 파일 시스템 개체가 아닌 디렉터리임을 지정합니다.

New-Item -Path "c:\" -Name "logfiles" -ItemType "directory"

예제 3: 프로필 만들기

이 명령은 변수에 지정된 $profile 경로에 PowerShell 프로필을 만듭니다.

프로필을 사용하여 PowerShell을 사용자 지정할 수 있습니다. $profile 는 "CurrentUser/CurrentHost" 프로필의 경로 및 파일 이름을 저장하는 자동(기본 제공) 변수입니다. PowerShell에서 경로와 파일 이름을 저장하더라도 기본적으로 프로필은 존재하지 않습니다.

이 명령에서 변수는 $profile 파일의 경로를 나타냅니다. ItemType 매개 변수는 명령이 파일을 만들 수 있도록 지정합니다. Force 매개 변수를 사용하면 경로의 디렉터리에 없는 경우에도 프로필 경로에 파일을 만들 수 있습니다.

프로필을 만든 후 프로필에 별칭, 함수 및 스크립트를 입력하여 셸을 사용자 지정할 수 있습니다.

자세한 내용은 about_Automatic_Variables 및 about_Profiles 참조하세요.

New-Item -Path $profile -ItemType "file" -Force

예제 4: 다른 디렉터리에 디렉터리 만들기

이 예제에서는 "C:\PS-Test" 디렉터리에 새 스크립트 디렉터리를 만듭니다.

새 디렉터리 항목의 이름인 "Scripts"는 Name 값 에 지정되지 않고 Path 매개 변수 값 에 포함됩니다. 구문에 표시된 대로 두 명령 형식이 모두 유효합니다.

New-Item -ItemType "directory" -Path "c:\ps-test\scripts"

예제 5: 여러 파일 만들기

이 예제에서는 두 개의 서로 다른 디렉터리에 파일을 만듭니다. 경로는 여러 문자열을 사용하므로 이를 사용하여 여러 항목을 만들 수 있습니다.

New-Item -ItemType "file" -Path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"

예제 6: 와일드카드를 사용하여 여러 디렉터리에 파일 만들기

cmdlet은 New-Item Path 매개 변수에서 와일드카드를 지원합니다. 다음 명령은 Path 매개 변수의 와일드카드로 지정된 모든 디렉터리에 파일을 만듭니다temp.txt.

Get-ChildItem -Path C:\Temp\

Directory:  C:\Temp

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d-----        5/15/2019   6:45 AM        1   One
d-----        5/15/2019   6:45 AM        1   Two
d-----        5/15/2019   6:45 AM        1   Three

New-Item -Path C:\Temp\* -Name temp.txt -ItemType File | Select-Object FullName

FullName
--------
C:\Temp\One\temp.txt
C:\Temp\Three\temp.txt
C:\Temp\Two\temp.txt

cmdlet은 Get-ChildItem 디렉터리 아래에 C:\Temp 세 개의 디렉터리를 표시합니다. 와일드카드를 사용하여 cmdlet은 New-Item 현재 디렉터리 아래의 모든 디렉터리에 파일을 만듭니다 temp.txt . cmdlet은 New-Item 새로 만든 파일의 경로를 확인하기 위해 Select-Object 파이프되는 사용자가 만든 항목을 출력합니다.

예제 7: 파일 또는 폴더에 대한 기호 링크 만들기

다음은 현재 폴더의 Notice.txt 파일에 대한 기호 링크를 만드는 예제입니다.

$link = New-Item -ItemType SymbolicLink -Path .\link -Target .\Notice.txt
$link | Select-Object LinkType, Target

LinkType     Target
--------     ------
SymbolicLink {.\Notice.txt}

이 예제에서 Target은 Value 매개 변수의 별칭입니다. 기호 링크의 대상은 정규화된 경로여야 합니다.

예제 8: -Force 매개 변수를 사용하여 폴더 다시 생성 시도

이 예제에서는 내부에 파일이 있는 폴더를 만듭니다. 그런 다음 , 를 사용하여 -Force동일한 폴더를 만들려고 시도합니다. 폴더를 덮어쓰지 않고 파일을 그대로 만든 기존 폴더 개체를 반환하기만 하면 됩니다.

PS> New-Item -Path .\TestFolder -ItemType Directory
PS> New-Item -Path .\TestFolder\TestFile.txt -ItemType File

PS> New-Item -Path .\TestFolder -ItemType Directory -Force

    Directory: C:\
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         5/1/2020   8:03 AM                TestFolder

PS> Get-ChildItem .\TestFolder\

    Directory: C:\TestFolder
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:03 AM              0 TestFile.txt

예제 9: -Force 매개 변수를 사용하여 기존 파일 덮어쓰기

이 예제에서는 값이 있는 파일을 만든 다음 -Force. 길이 속성에서 볼 수 있듯이 기존 파일을 덮어씁니다.

PS> New-Item ./TestFile.txt -ItemType File -Value 'This is just a test file'

    Directory: C:\Source\Test
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:32 AM             24 TestFile.txt

New-Item ./TestFile.txt -ItemType File -Force

    Directory: C:\Source\Test
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:32 AM              0 TestFile.txt

매개 변수

-ApplicationName

-Authentication

-CertificateThumbprint

-Confirm

-ConnectionURI

-Credential

-Force

-ItemType

-Name

-Options

-OptionSet

-Path

-Port

-SessionOption

-UseSSL

-UseTransaction

-Value

-WhatIf

입력

Object

새 항목의 값을 이 cmdlet으로 파이프할 수 있습니다.

출력

DictionaryEntry

cmdlet은 새 환경 변수를 만들 때 DictionaryEntry 개체를 반환합니다.

DirectoryInfo

이 cmdlet은 파일 시스템에 새 디렉터리를 만들 때 DirectoryInfo 개체를 반환합니다.

FileInfo

이 cmdlet은 파일 시스템에 새 파일을 만들 때 FileInfo 개체를 반환합니다.

AliasInfo

cmdlet은 새 별칭을 만들 때 AliasInfo 개체를 반환합니다.

FunctionInfo

cmdlet은 새 함수를 만들 때 FunctionInfo 개체를 반환합니다.

PSVariable

cmdlet은 새 변수를 만들 때 PSVariable 개체를 반환합니다.

참고

Windows PowerShell에는 다음 별칭이 포함됩니다.New-Item

• ni

New-Item 는 모든 공급자가 노출하는 데이터와 함께 작동하도록 설계되었습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 .를 입력 Get-PsProvider합니다. 자세한 내용은 about_Providers 참조하세요.

관련 링크

• Clear-Item
• Copy-Item
• Get-Item
• Invoke-Item
• 항목 이동
• Remove-Item
• Rename-Item
• Set-Item
• about_Providers