New-Item
Crea un elemento nuevo.
Syntax
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>]
Description
El New-Item
cmdlet 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.
Ejemplos
Ejemplo 1: Create un archivo en el directorio actual
Este comando crea un archivo de texto denominado "testfile1.txt" en el directorio actual. El punto ('.') del 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."
Ejemplo 2: Create un directorio
Este comando crea un directorio denominado "Logfiles" en la C:
unidad. El parámetro ItemType especifica que el nuevo elemento es un directorio, no un archivo u otro objeto del sistema de archivos.
New-Item -Path "c:\" -Name "logfiles" -ItemType "directory"
Ejemplo 3: Create un perfil
Este comando crea un perfil de PowerShell en la ruta de acceso especificada por la $profile
variable .
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 almacena una ruta de acceso y un nombre de archivo para él.
En este comando, la $profile
variable representa la ruta de acceso del archivo. El 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
Nota
Al crear un archivo mediante este método, el archivo resultante se codifica como UTF-8 sin una marca de orden de bytes (BOM).
Ejemplo 4: Create un directorio en otro directorio
En este ejemplo se crea un directorio Scripts en el directorio "C:\PS-Test".
El nombre del nuevo elemento de directorio, "Scripts", se incluye en el valor del parámetro Path , en lugar de especificarse en el valor de Name. Como indica la sintaxis, cualquier formato de comando es válido.
New-Item -ItemType "directory" -Path "c:\ps-test\scripts"
Ejemplo 5: Create varios archivos
En este ejemplo se crean archivos en dos directorios diferentes. Dado que Path 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"
Parámetros
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Nota
Este parámetro no es compatible con ningún proveedor instalado con PowerShell. Para suplantar a otro usuario o elevar sus credenciales al ejecutar este cmdlet, use Invoke-Command
.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Obliga a este cmdlet a crear un elemento que escribe sobre un elemento de solo lectura existente. La implementación varía en función del proveedor. Para obtener más información, consulte about_Providers. Incluso con el parámetro Force , el cmdlet no puede invalidar las restricciones de seguridad.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ItemType
Especifica el tipo especificado por el proveedor del elemento nuevo. Los valores disponibles de este parámetro dependen del proveedor actual que use.
Si la ubicación está en una FileSystem
unidad, se permiten los siguientes valores:
- Archivo
- Directorio
- SymbolicLink
- unión
- HardLink
Al crear un archivo mediante este método, el archivo resultante se codifica como UTF-8 sin una marca de orden de bytes (BOM).
En una Certificate
unidad, estos son los valores que puede especificar:
- Proveedor de certificados
- Certificado
- Tienda
- StoreLocation
Para obtener más información, consulte about_Providers.
Type: | String |
Aliases: | Type |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica el nombre del nuevo elemento.
Puede especificar el nombre del nuevo elemento en el valor del parámetro Name o Path , y puede especificar la ruta de acceso del nuevo elemento en nombre o valor de ruta de acceso .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Especifica la ruta de acceso de la ubicación del nuevo elemento. Se permite el uso de caracteres comodín.
Puede especificar el nombre del nuevo elemento en Nombre o incluirlo en Ruta de acceso.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro solo es válido cuando hay una transacción en curso. Para obtener más información, consulte about_Transactions.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Especifica el valor del nuevo elemento. También puede canalizar un valor a New-Item
.
Type: | Object |
Aliases: | Target |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Puede canalizar un valor para el nuevo elemento a este cmdlet.
Salidas
Este cmdlet devuelve el elemento que crea.
Notas
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.