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

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"

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.