Move-ItemProperty

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

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

Il cmdlet Move-ItemProperty sposta una proprietà di un elemento da un elemento a un altro. È possibile, ad esempio, spostare una voce del Registro di sistema da una chiave del Registro di sistema a un'altra. Quando si sposta la proprietà di un elemento, essa viene aggiunta alla nuova posizione ed eliminata da quella originale.

-Credential <PSCredential>

Specifica un account utente con autorizzazione per l'esecuzione di questa azione. Il valore predefinito è l'utente corrente.

Digitare un nome utente, ad esempio "Utente01" o "Dominio01\Utente01", o immettere un oggetto PSCredential, ad esempio uno generato dal cmdlet Get-Credential. Se si digita un nome utente, viene richiesta una password.

Questo parametro non è supportato dai provider installati con Windows PowerShell.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	true (ByPropertyName)
Accettare caratteri jolly?	false

-Destination <string>

Specifica il percorso di destinazione.

Obbligatorio?	true
Posizione?	2
Valore predefinito
Accettare input da pipeline?	true (ByPropertyName)
Accettare caratteri jolly?	false

-Exclude <string[]>

Omette gli elementi specificati. Il valore di questo parametro qualifica il parametro Path. Immettere un criterio o un elemento del percorso, ad esempio "*.txt". È consentito l'utilizzo di caratteri jolly.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Filter <string>

Specifica un filtro nel formato o nel linguaggio del provider. Il valore di questo parametro qualifica il parametro Path. La sintassi del filtro, incluso l'utilizzo dei caratteri jolly, dipende dal provider. I filtri sono più efficienti rispetto ad altri parametri, perché il provider li applica al momento del recupero degli oggetti, anziché utilizzare Windows PowerShell per filtrare gli oggetti dopo il recupero.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Force

Consente al cmdlet di spostare proprietà da o verso elementi altrimenti inaccessibili all'utente. L'implementazione varia a seconda del provider. Per ulteriori informazioni, vedere about_Providers.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Include <string[]>

Sposta unicamente gli elementi specificati. Il valore di questo parametro qualifica il parametro Path. Immettere un criterio o un elemento del percorso, ad esempio "*.txt". È consentito l'utilizzo di caratteri jolly.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-LiteralPath <string[]>

Specifica il percorso corrente della proprietà. A differenza di Path, il valore di LiteralPath viene utilizzato così come viene digitato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, è necessario racchiuderli tra virgolette singole tramite le quali si comunica a Windows PowerShell di non interpretare alcun carattere come sequenza di escape.

Obbligatorio?	true
Posizione?	1
Valore predefinito
Accettare input da pipeline?	true (ByPropertyName)
Accettare caratteri jolly?	false

-Name <string[]>

Specifica il nome della proprietà da spostare.

Obbligatorio?	true
Posizione?	3
Valore predefinito
Accettare input da pipeline?	true (ByPropertyName)
Accettare caratteri jolly?	false

-PassThru

Passa un oggetto che rappresenta la proprietà dell'elemento. Per impostazione predefinita, il cmdlet non genera alcun output.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Path <string[]>

Specifica il percorso corrente della proprietà. È consentito l'utilizzo di caratteri jolly.

Obbligatorio?	true
Posizione?	1
Valore predefinito
Accettare input da pipeline?	true (ByValue, ByPropertyName)
Accettare caratteri jolly?	false

-Confirm

Chiede una conferma prima di eseguire il comando.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-WhatIf

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-UseTransaction

Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per ulteriori informazioni, vedere about_Transactions.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

System.String

È possibile reindirizzare una stringa che contiene un percorso a Move-ItemProperty.

Output

Nessuno o System.Management.Automation.PSCustomObject

Quando si utilizza il parametro PassThru, Move-ItemProperty genera un oggetto PSCustomObject che rappresenta la proprietà dell'elemento spostato. Negli altri casi, il cmdlet non genera alcun output.

I nomi dei parametri Path, Destination e Name sono facoltativi. Se si omettono i nomi dei parametri, i valori dei parametri senza nome devono essere riportati nell'ordine seguente: Path, Destination, Name. Se si includono i nomi dei parametri, i parametri possono essere riportati in qualsiasi ordine.

È inoltre possibile fare riferimento a Move-ItemProperty tramite il relativo alias predefinito "mp". Per ulteriori informazioni, vedere about_Aliases.

Il cmdlet Move-ItemProperty è progettato per l'utilizzo di dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare "Get-PSProvider". Per ulteriori informazioni, vedere about_Providers.

C:\PS>move-itemproperty HKLM:\Software\MyCompany\MyApp -Name `
Version -Destination HKLM:\Software\MyCompany\NewApp

Descrizione
-----------
Con questo comando il valore del Registro di sistema "Version" e i relativi dati vengono spostati dalla sottochiave MyApp alla sottochiave NewApp della chiave del Registro di sistema HKLM\Software\MyCompany.

Move-ItemProperty

Sintassi

Descrizione

Parametri