Copy-ItemProperty

Copia una propiedad y su valor desde una ubicación especificada a otra ubicación.

Sintaxis

Copy-ItemProperty [-LiteralPath] <string[]> [-Destination] <string> [-Name] <string> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Copy-ItemProperty [-Path] <string[]> [-Destination] <string> [-Name] <string> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Descripción

El cmdlet Copy-ItemProperty copia una propiedad y su valor de una ubicación especificada en otra ubicación. Por ejemplo, puede utilizar Copy-ItemProperty para copiar una o más entradas del Registro de una clave del Registro en otra clave del Registro.

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.

-Destination <string>

Especifica la ruta de acceso a la ubicación de destino.

-Exclude <string[]>

Omite los elementos especificados. Se permite el uso de caracteres comodín.

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

-Force

Permite al cmdlet anular las restricciones, como el cambio de nombre de los archivos existentes, sin poner en peligro la seguridad.

-Include <string[]>

Especifica únicamente aquellos elementos sobre los que actuará el cmdlet, y excluye a todos los demás.

-LiteralPath <string[]>

Especifica la ruta de la propiedad del elemento. 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.

-Name <string>

Especifica el nombre de la propiedad que se va a copiar.

-PassThru

Devuelve un objeto que representa la propiedad del elemento copiado. De forma predeterminada, este cmdlet no genera resultados.

-Path <string[]>

Especifica la ruta de la propiedad que se va a copiar.

-Confirm

Solicita confirmación antes de ejecutar el comando.

-WhatIf

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

-UseTransaction

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

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

Notas

El cmdlet Copy-ItemProperty está diseñado para funcionar 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>copy-itemproperty -path MyApplication -destination HKLM:\Software\MyApplicationRev2 -name MyProperty

Descripción
-----------
Este comando copia la propiedad denominada MyProperty desde la clave del registro MyApplication a la clave del registro MyApplicationRev2.

Vea también

Conceptos

about_Providers
Clear-ItemProperty
New-ItemProperty
Move-ItemProperty
Rename-ItemProperty
Get-ItemProperty
Set-ItemProperty