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>]

El cmdlet New-Item crea un nuevo elemento y establece su valor. Los tipos de elementos que se pueden crear dependen de la ubicación del elemento. Por ejemplo, en el sistema de archivos, New-Item crea archivos y carpetas. En el Registro, New-Item crea claves y entradas del Registro.

New-Item también puede establecer el valor de los elementos que crea. Por ejemplo, cuando crea un nuevo archivo, New-Item puede agregar contenido inicial al archivo.

Este comando crea un archivo de texto denominado "testfile1.txt" en el directorio actual. El punto ('.') en el valor del parámetro Path indica el directorio actual. El texto entre comillas que sigue al parámetro Value se agrega al archivo como contenido.

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

Este comando crea un directorio denominado "Logfiles" en la unidad C:. El parámetro ItemType especifica que el nuevo elemento es un directorio, no un archivo u otro objeto de sistema de archivos.

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

Este comando crea un perfil de PowerShell en la ruta de acceso especificada por la variable $profile.

Puede usar perfiles para personalizar PowerShell. $profile es una variable automática (integrada) que almacena la ruta de acceso y el nombre de archivo del perfil "CurrentUser/CurrentHost". De forma predeterminada, el perfil no existe, aunque PowerShell almacene una ruta de acceso y un nombre de archivo para él.

En este comando, la variable $profile representa la ruta de acceso del archivo. parámetro ItemType especifica que el comando crea un archivo. El parámetro Force permite crear un archivo en la ruta de acceso del perfil, incluso cuando los directorios de la ruta de acceso no existen.

Después de crear un perfil, puede escribir alias, funciones y scripts en el perfil para personalizar el shell.

Para obtener más información, consulte about_Automatic_Variables y about_Profiles.

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

En este ejemplo se crea un nuevo directorio Scripts en el directorio "C:\PS-Test".

El nombre del nuevo elemento de directorio, "Scripts", se incluye en el valor de parámetro Path, en lugar de especificarse en el valor de Nombre. Como se indica en la sintaxis, cualquiera de los formularios de comando es válido.

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

En este ejemplo se crean archivos en dos directorios diferentes. Dado que ruta de acceso toma varias cadenas, puede usarla para crear varios elementos.

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

El cmdlet New-Item admite caracteres comodín en el parámetro Path. El comando siguiente crea un archivo temp.txt en todos los directorios especificados por los caracteres comodín del parámetro path de.

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

El cmdlet Get-ChildItem muestra tres directorios en el directorio C:\Temp. Con caracteres comodín, el cmdlet New-Item crea un archivo temp.txt en todos los directorios del directorio actual. El cmdlet New-Item genera los elementos que creó, que se canalizan a Select-Object para comprobar las rutas de acceso de los archivos recién creados.

En este ejemplo se crea un vínculo simbólico al archivo Notice.txt de la carpeta actual.

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

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

En este ejemplo, target es un alias para el parámetro Value de. El destino del vínculo simbólico puede ser una ruta de acceso relativa. Antes de PowerShell v6.2, el destino debe ser una ruta de acceso completa.

A partir de PowerShell 7.1, ahora puede crear en un SymbolicLink a una carpeta de Windows mediante una ruta de acceso relativa.

En este ejemplo se crea una carpeta con un archivo dentro. A continuación, intenta crear la misma carpeta mediante -Force. No sobrescribirá la carpeta, sino simplemente devolverá el objeto de carpeta existente con el archivo creado intacto.

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

En este ejemplo se crea un archivo con un valor y, a continuación, se vuelve a crear el archivo mediante -Force. Esto sobrescribe el archivo existente y perderá su contenido, como puede ver por la propiedad de longitud

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

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Puede canalizar un valor para el nuevo elemento a este cmdlet.

Este cmdlet devuelve el elemento que crea.

New-Item está diseñado para trabajar con los datos expuestos por cualquier proveedor. Para enumerar los proveedores disponibles en la sesión, escriba Get-PsProvider. Para obtener más información, consulte about_Providers.