Cambia el valor de un elemento por el valor especificado en el comando.

Sintaxis

Set-Item [-LiteralPath] <string[]> [[-Value] <Object>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Set-Item [-Path] <string[]> [[-Value] <Object>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Descripción

El cmdlet Set-Item cambia el valor de un elemento, como una variable o una clave del Registro, por el valor especificado en el comando.

Parámetros

-Credential <PSCredential>

Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01", o bien, escriba 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 los proveedores que se instalan con Windows PowerShell.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

true (ByPropertyName)

¿Aceptar caracteres comodín?

false

-Exclude <string[]>

Omite los elementos especificados. El valor de este parámetro califica el parámetro Path. Escriba un patrón o un elemento de la ruta de acceso, como "*.txt". Se permite el uso de caracteres comodín.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Filter <string>

Especifica un filtro en el formato o lenguaje del proveedor. El valor de este parámetro califica el parámetro Path. La sintaxis del filtro, incluido el uso de caracteres comodín, depende del proveedor. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica al recuperar los objetos en lugar de hacer que Windows PowerShell filtre los objetos después de recuperarlos.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Force

Permite al cmdlet establecer elementos que no se pueden cambiar de ningún otro modo, como alias o variables de solo lectura. El cmdlet no puede cambiar variables ni alias de constantes. La implementación varía según el proveedor. Para obtener más información, vea about_Providers. Incluso si se usa el parámetro Force, el cmdlet no puede invalidar las restricciones de seguridad.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Include <string[]>

Cambia únicamente los elementos especificados. El valor de este parámetro califica el parámetro Path. Escriba un patrón o un elemento de la ruta de acceso, como "*.txt". Se permite el uso de caracteres comodín.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-LiteralPath <string[]>

Especifica la ruta de acceso a la ubicación de los nuevos elementos. A diferencia de Path, el valor de LiteralPath se usa literalmente como se escribe. Ningún carácter se interpretará como un carácter comodín. Si la ruta incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a Windows PowerShell que no debe interpretar los caracteres como secuencias de escape.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

true (ByPropertyName)

¿Aceptar caracteres comodín?

false

-PassThru

Pasa a la canalización un objeto que representa el elemento. De forma predeterminada, este cmdlet no genera resultados.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Path <string[]>

Especifica la ruta de acceso a la ubicación de los nuevos elementos. Se permite el uso de caracteres comodín.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

true (ByPropertyName)

¿Aceptar caracteres comodín?

false

-Value <Object>

Especifica un valor nuevo para el elemento.

¿Requerido?

false

¿Posición?

2

Valor predeterminado

¿Aceptar canalización?

true (ByValue, ByPropertyName)

¿Aceptar caracteres comodín?

false

-Confirm

Solicita confirmación antes de ejecutar el comando.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-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, vea about_Transactions.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

System.Object

Puede canalizar a Set-Item un objeto que representa el nuevo valor del elemento.

Salidas

Ninguno o un objeto que representa el elemento nuevo o modificado.

Cuando se usa el parámetro Passthru, Set-Item genera un objeto que representa el elemento. En caso contrario, este cmdlet no genera resultados.

Notas

También puede hacer referencia a Set-Item mediante su alias integrado, "si". Para obtener más información, vea about_Aliases.

El cmdlet Set-Item no es compatible con el proveedor FileSystem de Windows PowerShell. Use Set-Content para cambiar los valores de los elementos del sistema de archivos.

En las unidades del Registro, HKLM: y HKCU:, Set-Item cambia los datos del valor (Predeterminado) de una clave del Registro. Para crear y cambiar los nombres de las claves del Registro, utilice New-Item y Rename-Item. Para cambiar los nombres y los datos de los valores del Registro, use New-ItemProperty, Set-ItemProperty y Rename-ItemProperty.

El cmdlet Set-Item está diseñado de modo que funcione con los datos expuestos por cualquier proveedor. Para mostrar los proveedores que están disponibles en la sesión, escriba "Get-PsProvider". Para obtener más información, vea about_Providers.

Ejemplo 1

C:\PS>set-item -path alias:np -value c:\windows\notepad.exe

Descripción
-----------
Este comando crea el alias "np" para Notepad.






Ejemplo 2

C:\PS>set-item -path env:UserRole -value Administrator

Descripción
-----------
Este comando usa el cmdlet Set-Item para cambiar el valor de la variable de entorno "UserRole" a "Administrator".






Ejemplo 3

C:\PS>set-item -path function:prompt -value {'PS '+ $(Get-Date -format t) + " " + $(Get-Location) + '> '}

Descripción
-----------
Este comando usa el cmdlet Set-Item para cambiar la función "prompt" de manera que muestre la hora delante de la ruta de acceso.






Ejemplo 4

C:\PS>set-item -path function:prompt -options "AllScope,ReadOnly"

Descripción
-----------
Este comando establece las opciones AllScope y ReadOnly de la función "prompt". Este comando usa el parámetro dinámico Options del cmdlet Set-Item. El parámetro Options está disponible en Set-Item únicamente cuando se usa con el proveedor Alias o Function.






Vea también




Tabla de contenido