Move-ItemProperty

  • Referência
Módulo:
Microsoft.PowerShell.Management

Move uma propriedade de uma localização para outra.

Syntax

Move-ItemProperty
    [-Path] <String[]>
    [-Name] <String[]>
    [-Destination] <String>
    [-PassThru]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Move-ItemProperty
    -LiteralPath <String[]>
    [-Name] <String[]>
    [-Destination] <String>
    [-PassThru]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O Move-ItemProperty cmdlet move uma propriedade de um item de um item para outro item. Por exemplo, pode mover uma entrada de registo de uma chave de registo para outra chave de registo. Quando move uma propriedade de item, esta é adicionada à nova localização e eliminada da localização original.

Exemplos

Exemplo 1: mover um valor de registo e os respetivos dados para outra chave

Este comando move o valor do Registo de versões e os respetivos dados da subchave "MyApp" para a subchave NewApp da chave de HKLM\Software\MyCompany registo.

Move-ItemProperty "HKLM:\Software\MyCompany\MyApp" -Name "Version" -Destination "HKLM:\Software\MyCompany\NewApp"

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Nota

Este parâmetro não é suportado por nenhum fornecedor instalado com o PowerShell. Para representar outro utilizador ou elevar as suas credenciais ao executar este cmdlet, utilize Invoke-Command.

Type:PSCredential
Position:Named
Default value:Current user
Accept pipeline input:True
Accept wildcard characters:False

-Destination

Especifica o caminho para a localização de destino.

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Exclude

Especifica, como uma matriz de cadeia, um item ou itens que este cmdlet exclui na operação. O valor deste parâmetro qualifica o parâmetro Caminho . Introduza um elemento ou padrão de caminho, como *.txt. Os carateres universais são permitidos. O parâmetro Excluir só é eficaz quando o comando inclui o conteúdo de um item, como C:\Windows\*, em que o caráter universal especifica o conteúdo do C:\Windows diretório.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Filter

Especifica um filtro para qualificar o parâmetro Caminho . O fornecedor fileSystem é o único fornecedor do PowerShell instalado que suporta a utilização de filtros. Pode encontrar a sintaxe da linguagem de filtro FileSystem no about_Wildcards. Os filtros são mais eficientes do que outros parâmetros, porque o fornecedor aplica-os quando o cmdlet obtém os objetos em vez de ter o PowerShell a filtrar os objetos depois de serem obtidos.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Force

Força o comando a ser executado sem pedir a confirmação do utilizador. A implementação varia de fornecedor para fornecedor. Para obter mais informações, veja about_Providers.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

Especifica, como uma matriz de cadeia, um item ou itens que este cmdlet inclui na operação. O valor deste parâmetro qualifica o parâmetro Caminho . Introduza um elemento ou padrão de caminho, como "*.txt". Os carateres universais são permitidos. O parâmetro Incluir só é eficaz quando o comando inclui o conteúdo de um item, como C:\Windows\*, em que o caráter universal especifica o conteúdo do C:\Windows diretório.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

Especifica um caminho para uma ou mais localizações. O valor do LiteralPath é utilizado exatamente como é escrito. Nenhum caráter é interpretado como carateres universais. Se o caminho incluir carateres de escape, coloque-o entre aspas. As aspas únicas indicam ao PowerShell para não interpretar os carateres como sequências de escape.

Para obter mais informações, veja about_Quoting_Rules.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica o nome da propriedade a mover.

Type:String[]
Aliases:PSProperty
Position:2
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Devolve um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet não gera quaisquer dados.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Path

Especifica o caminho para a localização atual da propriedade. Os carateres universais são permitidos.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Pode encaminhar uma cadeia que contém um caminho para este cmdlet.

Saídas

None

Por predefinição, este cmdlet não devolve nenhuma saída.

PSCustomObject

Quando utiliza o parâmetro PassThru , este cmdlet devolve um PSCustomObject que representa a propriedade do item movido.

Notas

O PowerShell inclui os seguintes aliases para Move-ItemProperty:

  • Todas as plataformas:
    • mp

Este cmdlet foi concebido para funcionar com os dados expostos por qualquer fornecedor. Para listar os fornecedores disponíveis na sua sessão, escreva Get-PSProvider. Para obter mais informações, veja about_Providers.