Sintaxis
mkdir <String> mkdir <String>] -Name <String> Descripción
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 se utiliza para crear 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, al crear un nuevo archivo, New-Item puede añadir contenido inicial al archivo.
Ejemplos
————————– EJEMPLO 1 ————————–
PS C:\>new-item -path . -name testfile1.txt -itemtype "file" -value "This is a text string."Este comando crea un archivo de texto llamado testfile1.txt en el directorio actual.El punto (.) en el valor del parámetro Path indica el directorio actual.El texto entrecomillado que sigue al parámetro Value se añade al archivo como contenido.
————————– EJEMPLO 2 ————————–
PS C:\>new-item -path c:\ -name logfiles -itemtype directoryEste comando crea un directorio llamado Logfiles en la unidad C:.El parámetro ItemType especifica que el nuevo elemento es un directorio, no un archivo u otro objeto del sistema de archivos.
————————– EJEMPLO 3 ————————–
PS C:\>new-item -path $profile -itemtype file -forceEste comando crea un perfil de Windows PowerShell en la ruta especificada por la variable $profile.
Puede utilizar perfiles para personalizar Windows PowerShell.$Profile es una variable automática (incorporada) que almacena la ruta y el nombre de archivo del perfil CurrentUser/CurrentHost.Por defecto, el perfil no existe, aunque Windows PowerShell almacena una ruta y un nombre de archivo para él.
En este comando, la variable $profile representa la ruta del archivo.El parámetro ItemType especifica que el comando crea un archivo.El parámetro Force permite crear un archivo en la ruta del perfil, incluso cuando los directorios de la ruta no existen (Windows PowerShell los crea).
Después de utilizar este comando para crear un perfil, puede introducir alias, funciones y scripts en el perfil para personalizar su shell.
Para más información, consulte about_Automatic_Variables y about_Profiles.
————————– EJEMPLO 4 ————————–
PS C:\>new-item -itemtype directory -path c:\ps-test\scriptsEste comando crea un nuevo directorio Scripts en el directorio C:\PS-Test.
El nombre del nuevo elemento del directorio, Scripts, se incluye en el valor del parámetro Path, en lugar de especificarse en el valor del parámetro Name.Como indica la sintaxis, cualquiera de las dos formas del comando es válida.
————————– EJEMPLO 5 ————————–
PS C:\>new-item -itemtype file -path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"Este comando utiliza el cmdlet New-Item para crear archivos en dos directorios diferentes.Como el parámetro Path admite varias cadenas, puede utilizarlo para crear varios elementos.
Parámetros requeridos
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 del nuevo elemento en el valor del parámetro Name o Path.
| Tipo: | Cadena |
| Posición: | Nombre |
| Valor por defecto: | Ninguno |
| Acepta la entrada de la tubería: | Verdadero (ByPropertyName) |
| Aceptar caracteres comodín: | Falso |
Especifica la ruta de acceso a la ubicación del nuevo elemento.Se permiten los comodines.
Puede especificar el nombre del nuevo elemento en el parámetro Name, o incluirlo en el parámetro Path.
| Tipo: | Cadena |
| Posición: | 1 |
| Valor por defecto: | Ninguno |
| Acepta la entrada de la tubería: | Verdadero (ByPropertyName) |
| Aceptar caracteres comodín: | Falso |
Parámetros opcionales
Le pide confirmación antes de ejecutar el cmdlet.Le pide confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Nombrado |
| Valor por defecto: | Falso |
| Acepta la entrada de la tubería: | Falso |
| Aceptar caracteres comodín: | Falso |
Especifica una cuenta de usuario que tiene permiso para realizar esta acción.El valor predeterminado es el usuario actual.
Escriba un nombre de usuario, como «User01» o «Domain01\User01», o introduzca un objeto PSCredential, como uno generado por el cmdlet Get-Credential.Si escribe un nombre de usuario, se le pedirá una contraseña.
Este parámetro no es compatible con ningún proveedor instalado con Windows PowerShell
| Tipo: | PSCredential |
| Posición: | Nombrado |
| Valor por defecto: | Ninguno |
| Acepta la entrada de la tubería: | Verdadero (ByPropertyName) |
| Aceptar caracteres comodín: | Falso |
Permite que el cmdlet cree un elemento que escriba sobre un elemento existente de sólo lectura.La implementación varía según el proveedor.Para obtener más información, consulte about_Providers.Incluso utilizando el parámetro Force, el cmdlet no puede anular las restricciones de seguridad.
| Tipo: | SwitchParameter |
| Posición: | Nombre |
| Valor por defecto: | Ninguno |
| Acepta la entrada de la tubería: | Falso |
| Aceptar caracteres comodín: | Falso |
Incluye el comando en la transacción activa.Este parámetro sólo es válido cuando hay una transacción en curso.Para más información, consulte Incluye el comando en la transacción activa.Este parámetro sólo es válido cuando hay una transacción en curso.Para más información, consulte
| Tipo: | SwitchParameter |
| Alias: | usetx |
| Posición: | Nombrado |
| Valor por defecto: | Falso |
| Acepta la entrada de la tubería: | Falso |
| Aceptar caracteres comodín: | Falso |
Especifica el valor del nuevo elemento.También puede canalizar un valor a New-Item.
| Tipo: | Objeto |
| Posición: | Nombrado |
| Valor por defecto: | Ninguno |
| Acepta la entrada de la tubería: | Verdadero (ByPropertyName, ByValue) |
| Aceptar caracteres comodín: | Falso |
Muestra lo que ocurriría si se ejecuta el cmdlet.El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Nombrado |
| Valor por defecto: | Falso |
| Acepta la entrada de la tubería: | Falso |
| Aceptar caracteres comodín: | Falso |
Entradas
System.Object
Puede canalizar un valor para el nuevo elemento al cmdlet New-Item.
Salidas
System.Object
New-Item devuelve el elemento que crea.
Notas
El cmdlet New-Item está diseñado para trabajar con los datos expuestos por cualquier proveedor.Para listar los proveedores disponibles en su sesión, escriba «Get-PsProvider».Para más información, consulte about_Providers.
- Clear-Item
- Copy-Item
- Get-Item
- Invoke-Item
- Move-Item
- Remove-Item
- Rename-Item
- Set-Item
- about_Providers