Modifica il valore di un elemento nel valore specificato nel comando.

Sintassi

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

Descrizione

Tramite il cmdlet Set-Item viene modificato il valore di un elemento, ad esempio una variabile o una chiave del Registro di sistema, nel valore specificato nel comando.

Parametri

-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

-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 impostare elementi che non possono essere modificati in altro modo, ad esempio alias di sola lettura o variabili. Il cmdlet non può cambiare gli alias o le variabile costanti. L'implementazione varia a seconda del provider. Per ulteriori informazioni, vedere about_Providers. Quando si utilizza il parametro Force, il cmdlet non può ignorare le limitazioni di sicurezza.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Include <string[]>

Modifica 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 un percorso dei nuovi elementi. 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

-PassThru

Passa un oggetto che rappresenta l'elemento alla pipeline. 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 un percorso dei nuovi elementi. È consentito l'utilizzo di caratteri jolly.

Obbligatorio?

true

Posizione?

1

Valore predefinito

Accettare input da pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

false

-Value <Object>

Specifica un nuovo valore per l'elemento.

Obbligatorio?

false

Posizione?

2

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.

Input e output

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

È possibile reindirizzare un oggetto che rappresenta il nuovo valore dell'elemento a Set-Item.

Output

Nessuno o un oggetto che rappresenta l'elemento nuovo o modificato.

Quando si utilizza il parametro Passthru, con Set-Item viene generato un oggetto che rappresenta l'elemento. Negli altri casi, il cmdlet non genera alcun output.

Note

È inoltre possibile fare riferimento a Set-Item tramite il relativo alias predefinito "si". Per ulteriori informazioni, vedere about_Aliases.

Il cmdlet Set-Item non è supportato dal provider FileSystem di Windows PowerShell. Per modificare i valori di elementi nel file system, utilizzare Set-Content.

Nelle unità Registry, HKLM: e HKCU:, tramite Set-Item vengono modificati i dati nel valore (predefinito) di una chiave del Registro di sistema. Per creare e modificare i nomi delle chiavi del Registro di sistema, utilizzare New-Item e Rename-Item. È possibile utilizzare New-ItemProperty, Set-ItemProperty e Rename-ItemProperty per modificare nomi e dati nei valori del Registro di sistema.

Il cmdlet Set-Item è 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.

Esempio 1

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

Descrizione
-----------
Tramite questo comando viene creato un alias di "np" per Blocco note.

Esempio 2

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

Descrizione
-----------
Questo comando utilizza il cmdlet Set-Item per modificare il valore della variabile di ambiente "UserRole" in "Administrator".

Esempio 3

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

Descrizione
-----------
Tramite questo comando viene utilizzato il cmdlet Set-Item per modificare la funzione "prompt" affinché le informazioni relative a data e ora vengano visualizzate prima del percorso.

Esempio 4

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

Descrizione
-----------
Tramite questo comando vengono impostate le opzioni AllScope e ReadOnly per la funzione "prompt". Viene utilizzato il parametro dinamico Options del cmdlet Set-Item. Il parametro Options è disponibile in Set-Item solo se utilizzato con il provider Alias o Function.

Vedere anche



Argomenti della Guida