Set-Item

Sintaxis

Path (valor predeterminado)

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

LiteralPath

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

Description

Ejemplos

Ejemplo 1: Creación de un alias

Set-Item -Path alias:np -Value "c:\windows\notepad.exe"

Ejemplo 2: Cambiar el valor de una variable de entorno

Set-Item -Path env:UserRole -Value "Administrator"

Ejemplo 3: Modificación de la función prompt

Set-Item -Path function:prompt -Value {'PS '+ $(Get-Date -Format t) + " " + $(Get-Location) + '> '}

Ejemplo 4: Establecimiento de opciones para la función prompt

Set-Item -Path function:prompt -Options "AllScope,ReadOnly"

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Conjuntos de parámetros

-Credential

Propiedades de parámetro

Conjuntos de parámetros

-Exclude

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet excluye en la operación. El valor de este parámetro define el parámetro Path. Escriba un elemento de ruta o patrón, como *.txt. Se permite el uso de caracteres comodín. El parámetro Exclude solo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del directorio C:\Windows.

Propiedades de parámetro

Conjuntos de parámetros

-Filter

Especifica un filtro para calificar el parámetro Path. El proveedor de FileSystem es el único proveedor de PowerShell instalado que admite el uso de filtros. Puede encontrar la sintaxis del lenguaje de filtro de FileSystem en about_Wildcards. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica cuando el cmdlet obtiene los objetos en lugar de que PowerShell filtre los objetos una vez recuperados.

Propiedades de parámetro

Conjuntos de parámetros

-Force

Obliga al cmdlet a establecer elementos que de lo contrario no se pueden cambiar, como alias o variables de solo lectura. El cmdlet no puede cambiar los alias o variables constantes. La implementación varía de proveedor a 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.

Propiedades de parámetro

Conjuntos de parámetros

-Include

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet incluye en la operación. El valor de este parámetro define el parámetro Path. Escriba un elemento de ruta o patrón, como "*.txt". Se permite el uso de caracteres comodín. El parámetro Include solo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del directorio C:\Windows.

Propiedades de parámetro

Conjuntos de parámetros

-LiteralPath

Especifica una ruta de acceso a una o varias ubicaciones. El valor de LiteralPath se usa tal como está escrito. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.

Para obtener más información, consulte sobre_las_normas_de_citación.

Propiedades de parámetro

Conjuntos de parámetros

-PassThru

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

Propiedades de parámetro

Conjuntos de parámetros

-Path

Especifica una ruta hacia la ubicación de los elementos. Se permite el uso de caracteres comodín.

Propiedades de parámetro

Conjuntos de parámetros

-UseTransaction

Incluye el comando en la transacción activa. Este parámetro solo es válido cuando una transacción está en curso. Para obtener más información, vea about_Transactions.

Propiedades de parámetro

Conjuntos de parámetros

-Value

Especifica un nuevo valor para el elemento.

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

Object

Salidas

None or an object representing the new or changed item.

Notas

Vínculos relacionados

• Clear-Item
• Copy-Item
• Get-Item
• Invoke-Item
• Move-Item
• New-Item
• Remove-Item
• Rename-Item
• Acerca de los Proveedores