New-Item

New-Item
    [-Path] <String[]>
    [-ItemType <String>]
    [-Value <Object>]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-Item
    [[-Path] <String[]>]
    -Name <String>
    [-ItemType <String>]
    [-Value <Object>]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-Item
    [-Path] <string[]>
    -ConnectionURI <uri>
    [-ItemType <string>]
    [-Value <Object>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-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]
    [-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]
    [-Options <ScopedItemOptions>]
    [<CommonParameters>]

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

Командлет New-Item создает новый элемент и задает его значение. Типы элементов, которые можно создать, зависят от расположения элемента. Например, в файловой системе New-Item создавать файлы и папки. В реестре New-Item создает разделы и записи реестра.

New-Item также может задать значение создаваемых элементов. Например, при создании нового файла New-Item может добавить исходное содержимое в файл.

Эта команда создает текстовый файл с именем "testfile1.txt" в текущем каталоге. Точка ('.') в значении параметра Path указывает текущий каталог. Приведенный в кавычки текст, следующий за параметром значения , добавляется в файл в виде содержимого.

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

Эта команда создает каталог с именем Logfiles на диске C:. Параметр ItemType указывает, что новый элемент является каталогом, а не файлом или другим объектом файловой системы.

New-Item -Path "C:\" -Name "Logfiles" -ItemType "Directory"

Эта команда создает профиль PowerShell в пути, указанном переменной $PROFILE.

Профили можно использовать для настройки PowerShell. $PROFILE — это автоматическая (встроенная) переменная, которая хранит путь и имя файла профиля CurrentUser/CurrentHost. По умолчанию профиль не существует, даже если PowerShell хранит путь и имя файла для него.

В этой команде переменная $PROFILE представляет путь к файлу. параметр ItemType указывает, что команда создает файл. Параметр Force позволяет создать файл в пути профиля, даже если каталоги в пути не существуют.

После создания профиля можно ввести псевдонимы, функции и скрипты в профиле, чтобы настроить оболочку.

Дополнительные сведения см. в about_Automatic_Variables и about_Profiles.

New-Item -Path $PROFILE -ItemType "File" -Force

В этом примере создается новый каталог скриптов в каталоге C:\PS-Test.

Имя нового элемента каталога "Скрипты" включается в значение параметра Path, а не указано в значении Name. Как указано в синтаксисе, любая форма команды допустима.

New-Item -ItemType "Directory" -Path "C:\ps-test\scripts"

В этом примере создаются файлы в двух разных каталогах. Так как пути принимает несколько строк, его можно использовать для создания нескольких элементов.

New-Item -ItemType "File" -Path "C:\ps-test\test.txt", "C:\ps-test\Logs\test.log"

Командлет New-Item поддерживает подстановочные знаки в параметре 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

Командлет Get-ChildItem отображает три каталога в каталоге C:\Temp. С помощью подстановочных знаков командлет New-Item создает файл temp.txt во всех каталогах в текущем каталоге. Командлет New-Item выводит созданные элементы, которые передаются в Select-Object для проверки путей только что созданных файлов.

В этом примере создается символьная ссылка на файл Notice.txt в текущей папке.

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

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

В этом примере Target является псевдонимом параметра значения. Цель символьной ссылки может быть относительным путем. До PowerShell версии 6.2 целевой объект должен быть полным путем.

Начиная с PowerShell 7.1, теперь вы можете создать Символьныйlink в папку в Windows с помощью относительного пути.

В этом примере создается папка с файлом внутри. Затем пытается создать ту же папку с помощью -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

В этом примере создается файл, содержащий значение, а затем воссоздается файл с помощью параметра Force. Это перезаписывает существующий файл, как показано свойством Length.

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

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Можно передать значение нового элемента в этот командлет.

Командлет возвращает объект DictionaryEntry при создании новой переменной среды.

Командлет возвращает объект DirectoryInfo при создании нового каталога в файловой системе.

Командлет возвращает объект FileInfo при создании нового файла в файловой системе.

Командлет возвращает объект AliasInfo при создании нового псевдонима.

Командлет возвращает объект FunctionInfo при создании новой функции.

Командлет возвращает объект PSVariable при создании новой переменной.

PowerShell включает следующие псевдонимы для New-Item:

• Все платформы:
  • ni

New-Item предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы вывести список поставщиков, доступных в сеансе, введите Get-PSProvider. Дополнительные сведения см. в разделе о поставщиках.