Informazioni su ParametricomuniAbout CommonParameters

DESCRIZIONE BREVESHORT DESCRIPTION

Vengono descritti i parametri che possono essere utilizzati con qualsiasi cmdlet.Describes the parameters that can be used with any cmdlet.

DESCRIZIONE LUNGALONG DESCRIPTION

I parametri comuni sono un set di parametri del cmdlet che è possibile usare con qualsiasi cmdlet.The common parameters are a set of cmdlet parameters that you can use with any cmdlet. Sono implementati da PowerShell, non dallo sviluppatore di cmdlet, e sono automaticamente disponibili per qualsiasi cmdlet.They're implemented by PowerShell, not by the cmdlet developer, and they're automatically available to any cmdlet.

È possibile utilizzare i parametri comuni con qualsiasi cmdlet, ma potrebbero non influire su tutti i cmdlet.You can use the common parameters with any cmdlet, but they might not have an effect on all cmdlets. Se, ad esempio, un cmdlet non genera alcun output dettagliato, l'uso del parametro comune verbose non ha alcun effetto.For example, if a cmdlet doesn't generate any verbose output, using the Verbose common parameter has no effect.

I parametri comuni sono disponibili anche in funzioni avanzate che usano l'attributo di cmdlet o l'attributo Parameter .The common parameters are also available on advanced functions that use the CmdletBinding attribute or the Parameter attribute.

Molti parametri comuni eseguono l'override delle impostazioni predefinite o delle preferenze di sistema impostate usando le variabili di preferenza di PowerShell.Several common parameters override system defaults or preferences that you set by using the PowerShell preference variables. Diversamente dalle variabili di preferenza, i parametri comuni influiscono solo sui comandi in cui sono usati.Unlike the preference variables, the common parameters affect only the commands in which they're used.

Per ulteriori informazioni, vedere about_Preference_Variables.For more information, see about_Preference_Variables.

Nell'elenco seguente vengono visualizzati i parametri comuni.The following list displays the common parameters. Gli alias sono elencati tra parentesi.Their aliases are listed in parentheses.

  • Debug (db)Debug (db)
  • ErrorAction (EA)ErrorAction (ea)
  • ErrorVariable (EV)ErrorVariable (ev)
  • InformationAction (infa)InformationAction (infa)
  • InformationVariable (IV)InformationVariable (iv)
  • OutVariable (OV)OutVariable (ov)
  • OutBuffer (ob)OutBuffer (ob)
  • PipelineVariable (PV)PipelineVariable (pv)
  • Verbose (VB)Verbose (vb)
  • WarningAction (WA)WarningAction (wa)
  • WarningVariable (WV)WarningVariable (wv)

I parametri di azione sono valori di tipo preferenzaazione .The Action parameters are ActionPreference type values. Preferenzaazione è un'enumerazione con i valori seguenti:ActionPreference is an enumeration with the following values:

NomeName ValoreValue
SospendiSuspend 55
IgnoraIgnore 44
VerificaInquire 33
ContinuaContinue 22
InterrompereStop 11
SilentlyContinueSilentlyContinue 00

È possibile utilizzare il nome o il valore con il parametro.You may use the name or the value with the parameter.

Oltre ai parametri comuni, molti cmdlet offrono parametri di mitigazione dei rischi.In addition to the common parameters, many cmdlets offer risk mitigation parameters. I cmdlet che coinvolgono il rischio per il sistema o i dati utente in genere offrono questi parametri.Cmdlets that involve risk to the system or to user data usually offer these parameters.

I parametri di mitigazione dei rischi sono:The risk mitigation parameters are:

  • WhatIf (Wi)WhatIf (wi)
  • Conferma (CF)Confirm (cf)

DESCRIZIONI DEI PARAMETRI COMUNICOMMON PARAMETER DESCRIPTIONS

DebugDebug

Visualizza i dettagli a livello di programmatore sull'operazione eseguita dal comando.Displays programmer-level detail about the operation done by the command. Questo parametro funziona solo quando il comando genera un messaggio di debug.This parameter works only when the command generates a debugging message. Questo parametro, ad esempio, funziona quando un comando contiene il Write-Debug cmdlet.For example, this parameter works when a command contains the Write-Debug cmdlet.

Type: SwitchParameter
Aliases: db

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Per impostazione predefinita, i messaggi di debug non vengono visualizzati perché il valore della $DebugPreference variabile è SilentlyContinue.By default, debugging messages aren't displayed because the value of the $DebugPreference variable is SilentlyContinue.

In modalità interattiva, il parametro debug esegue l'override del valore della $DebugPreference variabile per il comando corrente, impostando il valore di $DebugPreference su domandi.In interactive mode, the Debug parameter overrides the value of the $DebugPreference variable for the current command, setting the value of $DebugPreference to Inquire.

In modalità non interattiva, il parametro debug esegue l'override del valore della $DebugPreference variabile per il comando corrente, impostando il valore di $DebugPreference su continue.In non-interactive mode, the Debug parameter overrides the value of the $DebugPreference variable for the current command, setting the value of $DebugPreference to Continue.

-Debug:$true ha lo stesso effetto di -Debug .-Debug:$true has the same effect as -Debug. Usare -Debug:$false per evitare la visualizzazione dei messaggi di debug quando $DebugPreference non è SilentlyContinue, che è l'impostazione predefinita.Use -Debug:$false to suppress the display of debugging messages when $DebugPreference isn't SilentlyContinue, which is the default.

ErrorActionErrorAction

Determina il modo in cui il cmdlet risponde a un errore non fatale dal comando.Determines how the cmdlet responds to a non-terminating error from the command. Questo parametro funziona solo quando il comando genera un errore non fatale, ad esempio quelli del Write-Error cmdlet.This parameter works only when the command generates a non-terminating error, such as those from the Write-Error cmdlet.

Type: ActionPreference
Aliases: ea
Accepted values: Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue

Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

Il parametro ErrorAction esegue l'override del valore della $ErrorActionPreference variabile per il comando corrente.The ErrorAction parameter overrides the value of the $ErrorActionPreference variable for the current command. Poiché il valore predefinito della $ErrorActionPreference variabile è continue, vengono visualizzati i messaggi di errore e l'esecuzione continua a meno che non si usi il parametro ErrorAction .Because the default value of the $ErrorActionPreference variable is Continue, error messages are displayed and execution continues unless you use the ErrorAction parameter.

Il parametro ErrorAction non ha alcun effetto sugli errori di terminazione (ad esempio, dati mancanti, parametri non validi o autorizzazioni insufficienti) che impediscono il corretto completamento di un comando.The ErrorAction parameter has no effect on terminating errors (such as missing data, parameters that aren't valid, or insufficient permissions) that prevent a command from completing successfully.

-ErrorAction:Continue visualizzare il messaggio di errore e continuare a eseguire il comando.-ErrorAction:Continue display the error message and continues executing the command. Continue è l'impostazione predefinita.Continue is the default.

-ErrorAction:Ignore evita il messaggio di errore e continua l'esecuzione del comando.-ErrorAction:Ignore suppresses the error message and continues executing the command. Diversamente da SilentlyContinue, Ignore non aggiunge il messaggio di errore alla $Error variabile automatica.Unlike SilentlyContinue, Ignore doesn't add the error message to the $Error automatic variable. Il valore Ignore è stato introdotto in PowerShell 3,0.The Ignore value is introduced in PowerShell 3.0.

-ErrorAction:Inquire Visualizza il messaggio di errore e richiede la conferma prima di continuare l'esecuzione.-ErrorAction:Inquire displays the error message and prompts you for confirmation before continuing execution. Questo valore viene usato raramente.This value is rarely used.

-ErrorAction:SilentlyContinue evita il messaggio di errore e continua l'esecuzione del comando.-ErrorAction:SilentlyContinue suppresses the error message and continues executing the command.

-ErrorAction:Stop Visualizza il messaggio di errore e arresta l'esecuzione del comando.-ErrorAction:Stop displays the error message and stops executing the command.

-ErrorAction:Suspend è disponibile solo per i flussi di lavoro che non sono supportati in PowerShell 6 e versioni successive.-ErrorAction:Suspend is only available for workflows which aren't supported in PowerShell 6 and beyond.

Nota

Il parametro ErrorAction esegue l'override di, ma non sostituisce il valore della $ErrorAction variabile di preferenza quando il parametro viene usato in un comando per eseguire uno script o una funzione.The ErrorAction parameter overrides, but does not replace the value of the $ErrorAction preference variable when the parameter is used in a command to run a script or function.

ErrorVariableErrorVariable

ErrorVariable archivia i messaggi di errore relativi al comando nella variabile specificata e nella $Error variabile automatica.ErrorVariable stores error messages about the command in the specified variable and in the $Error automatic variable. Per ulteriori informazioni, vedere about_Automatic_VariablesFor more information, see about_Automatic_Variables

Type: String
Aliases: ev

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

Per impostazione predefinita, i nuovi messaggi di errore sovrascrivono i messaggi di errore già archiviati nella variabile.By default, new error messages overwrite error messages that are already stored in the variable. Per aggiungere il messaggio di errore al contenuto della variabile, digitare un segno più ( + ) prima del nome della variabile.To append the error message to the variable content, type a plus sign (+) before the variable name.

Ad esempio, il comando seguente crea la $a variabile e quindi archivia eventuali errori:For example, the following command creates the $a variable and then stores any errors in it:

Get-Process -Id 6 -ErrorVariable a

Il comando seguente aggiunge tutti i messaggi di errore alla $a variabile:The following command adds any error messages to the $a variable:

Get-Process -Id 2 -ErrorVariable +a

Il seguente comando Visualizza il contenuto di $a :The following command displays the contents of $a:

$a

È possibile utilizzare questo parametro per creare una variabile che contiene solo messaggi di errore da comandi specifici e non influisce sul comportamento della $Error variabile automatica.You can use this parameter to create a variable that contains only error messages from specific commands and does not affect the behavior of the $Error automatic variable. La $Error variabile automatica contiene i messaggi di errore di tutti i comandi della sessione.The $Error automatic variable contains error messages from all the commands in the session. È possibile utilizzare la notazione di matrice, ad esempio $a[0] o, $error[1,2] per fare riferimento a errori specifici archiviati nelle variabili.You can use array notation, such as $a[0] or $error[1,2] to refer to specific errors stored in the variables.

Nota

La variabile di errore personalizzata contiene tutti gli errori generati dal comando, inclusi gli errori delle chiamate a funzioni o script annidati.The custom error variable contains all errors generated by the command, including errors from calls to nested functions or scripts.

InformationActionInformationAction

Introdotta in PowerShell 5,0.Introduced in PowerShell 5.0. All'interno del comando o dello script in cui viene usato, il parametro comune InformationAction esegue l'override del valore della $InformationPreference variabile di preferenza, che per impostazione predefinita è impostato su SilentlyContinue.Within the command or script in which it's used, the InformationAction common parameter overrides the value of the $InformationPreference preference variable, which by default is set to SilentlyContinue. Quando si usa Write-Information in uno script con InformationAction, Write-Information i valori vengono visualizzati a seconda del valore del parametro InformationAction .When you use Write-Information in a script with InformationAction, Write-Information values are shown depending on the value of the InformationAction parameter. Per ulteriori informazioni su $InformationPreference , vedere about_Preference_Variables.For more information about $InformationPreference, see about_Preference_Variables.

Type: ActionPreference
Aliases: ia
Accepted values: Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue

Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

-InformationAction:Stop arresta un comando o uno script in un'occorrenza del Write-Information comando.-InformationAction:Stop stops a command or script at an occurrence of the Write-Information command.

-InformationAction:Ignore Disattiva il messaggio informativo e continua l'esecuzione del comando.-InformationAction:Ignore suppresses the informational message and continues running the command. Diversamente da SilentlyContinue, Ignora dimentica completamente il messaggio informativo. il messaggio informativo non viene aggiunto al flusso di informazioni.Unlike SilentlyContinue, Ignore completely forgets the informational message; it doesn't add the informational message to the information stream.

-InformationAction:Inquire Visualizza il messaggio informativo specificato in un Write-Information comando, quindi chiede se si vuole continuare.-InformationAction:Inquire displays the informational message that you specify in a Write-Information command, then asks whether you want to continue.

-InformationAction:Continue viene visualizzato il messaggio informativo e l'esecuzione continua.-InformationAction:Continue displays the informational message, and continues running.

-InformationAction:Suspend non è supportato in PowerShell Core perché è disponibile solo per i flussi di lavoro.-InformationAction:Suspend isn't supported on PowerShell Core as it is only available for workflows.

-InformationAction:SilentlyContinue Nessun effetto perché il messaggio informativo non è visualizzato (impostazione predefinita) e lo script continua senza interruzioni.-InformationAction:SilentlyContinue no effect as the informational message aren't (Default) displayed, and the script continues without interruption.

Nota

Il parametro InformationAction esegue l'override di, ma non sostituisce il valore della $InformationAction variabile di preferenza quando il parametro viene usato in un comando per eseguire uno script o una funzione.The InformationAction parameter overrides, but does not replace the value of the $InformationAction preference variable when the parameter is used in a command to run a script or function.

InformationVariableInformationVariable

Introdotta in PowerShell 5,0.Introduced in PowerShell 5.0. All'interno del comando o dello script in cui viene usato, il parametro comune InformationVariable archivia in una variabile una stringa specificata aggiungendo il Write-Information comando.Within the command or script in which it's used, the InformationVariable common parameter stores in a variable a string that you specify by adding the Write-Information command. Write-Information i valori vengono visualizzati a seconda del valore del parametro comune InformationAction . Se non si aggiunge il parametro comune InformationAction , le Write-Information stringhe vengono visualizzate a seconda del valore della $InformationPreference variabile di preferenza.Write-Information values are shown depending on the value of the InformationAction common parameter; if you don't add the InformationAction common parameter, Write-Information strings are shown depending on the value of the $InformationPreference preference variable. Per ulteriori informazioni su $InformationPreference , vedere about_Preference_Variables.For more information about $InformationPreference, see about_Preference_Variables.

Nota

La variabile Information contiene tutti i messaggi informativi generati dal comando, inclusi i messaggi informativi dalle chiamate a funzioni o script annidati.The information variable contains all information messages generated by the command, including information messages from calls to nested functions or scripts.

Type: String
Aliases: iv

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

OutBufferOutBuffer

Determina il numero di oggetti da accumulare in un buffer prima che qualsiasi oggetto venga inviato tramite la pipeline.Determines the number of objects to accumulate in a buffer before any objects are sent through the pipeline. Se si omette questo parametro, gli oggetti vengono inviati man mano che vengono generati.If you omit this parameter, objects are sent as they're generated.

Type: Int32
Aliases: ob

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

Questo parametro di gestione delle risorse è progettato per gli utenti avanzati.This resource management parameter is designed for advanced users. Quando si usa questo parametro, PowerShell invia i dati al cmdlet successivo in batch di OutBuffer + 1 .When you use this parameter, PowerShell sends data to the next cmdlet in batches of OutBuffer + 1.

Nell'esempio seguente vengono visualizzate le alternative per ForEach-Object elaborare i blocchi che utilizzano il Write-Host cmdlet.The following example alternates displays between to ForEach-Object process blocks that use the Write-Host cmdlet. La visualizzazione viene alternata in batch di 2 o OutBuffer + 1 .The display alternates in batches of 2 or OutBuffer + 1.

1..4 | ForEach-Object {
        Write-Host "$($_): First"; $_
      } -OutBuffer 1 | ForEach-Object {
                        Write-Host "$($_): Second" }
1: First
2: First
1: Second
2: Second
3: First
4: First
3: Second
4: Second

OutVariableOutVariable

Archivia gli oggetti di output dal comando nella variabile specificata, oltre a inviare l'output lungo la pipeline.Stores output objects from the command in the specified variable in addition to sending the output along the pipeline.

Type: String
Aliases: ov

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

Per aggiungere l'output alla variabile, anziché sostituire un output che potrebbe essere già archiviato, digitare un segno più ( + ) prima del nome della variabile.To add the output to the variable, instead of replacing any output that might already be stored there, type a plus sign (+) before the variable name.

Ad esempio, il comando seguente crea la $out variabile e archivia l'oggetto processo al suo interno:For example, the following command creates the $out variable and stores the process object in it:

Get-Process PowerShell -OutVariable out

Il comando seguente aggiunge l'oggetto processo alla $out variabile:The following command adds the process object to the $out variable:

Get-Process iexplore -OutVariable +out

Il seguente comando Visualizza il contenuto della $out variabile:The following command displays the contents of the $out variable:

$out

Nota

La variabile creata dal parametro Outvariant è un oggetto [System.Collections.ArrayList] .The variable created by the OutVariable parameter is a [System.Collections.ArrayList].

PipelineVariablePipelineVariable

PipelineVariable archivia il valore dell'elemento della pipeline corrente come variabile, per qualsiasi comando denominato che scorre attraverso la pipeline.PipelineVariable stores the value of the current pipeline element as a variable, for any named command as it flows through the pipeline.

Nota

Le funzioni avanzate possono avere fino a tre blocchi di script: begin , process e end .Advanced functions can have up to three script blocks: begin, process, and end. Quando si usa il parametro PipelineVariable con funzioni avanzate, vengono assegnati alla variabile solo i valori del primo blocco di script definito, mentre viene eseguita la funzione.When using the PipelineVariable parameter with advanced functions, only values from the first defined script block are assigned to the variable as the function runs. Per ulteriori informazioni, vedere funzioni avanzate.For more information, see Advanced functions. PowerShell 7,2 corregge questo comportamento.PowerShell 7.2 corrects this behavior.

Type: String
Aliases: pv

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

I valori validi sono stringhe, come per qualsiasi nome di variabile.Valid values are strings, the same as for any variable names.

Di seguito è riportato un esempio del funzionamento di PipelineVariable .The following is an example of how PipelineVariable works. In questo esempio, il parametro PipelineVariable viene aggiunto a un Foreach-Object comando per archiviare i risultati del comando nelle variabili.In this example, the PipelineVariable parameter is added to a Foreach-Object command to store the results of the command in variables. Un intervallo di numeri, da 1 a 10, viene reindirizzato al primo Foreach-Object comando, i cui risultati vengono archiviati in una variabile denominata Left.A range of numbers, 1 to 10, are piped into the first Foreach-Object command, the results of which are stored in a variable named Left.

I risultati del primo Foreach-Object comando vengono inviati tramite pipe a un secondo Foreach-Object comando, che filtra gli oggetti restituiti dal primo Foreach-Object comando.The results of the first Foreach-Object command are piped into a second Foreach-Object command, which filters the objects returned by the first Foreach-Object command. I risultati del secondo comando vengono archiviati in una variabile denominata right.The results of the second command are stored in a variable named Right.

Nel terzo Foreach-Object comando i risultati dei primi due Foreach-Object comandi inviati tramite pipe, rappresentati dalle variabili Left e right, vengono elaborati tramite un operatore di moltiplicazione.In the third Foreach-Object command, the results of the first two Foreach-Object piped commands, represented by the variables Left and Right, are processed by using a multiplication operator. Il comando indica agli oggetti archiviati nelle variabili a destra e a sinistra di essere moltiplicati e specifica che i risultati devono essere visualizzati come "membro intervallo sinistro * diritto intervallo membro = prodotto".The command instructs objects stored in the Left and Right variables to be multiplied, and specifies that the results should be displayed as "Left range member * Right range member = product".

1..10 | Foreach-Object -PipelineVariable Left -Process { $_ } |
  Foreach-Object -PV Right -Process { 1..10 } |
  Foreach-Object -Process { "$Left * $Right = " + ($Left*$Right) }
1 * 1 = 1
1 * 2 = 2
1 * 3 = 3
1 * 4 = 4
1 * 5 = 5
...

DettagliatoVerbose

Visualizza informazioni dettagliate sull'operazione eseguita dal comando.Displays detailed information about the operation done by the command. Queste informazioni sono simili a quelle contenute in una traccia o in un log delle transazioni.This information resembles the information in a trace or in a transaction log. Questo parametro funziona solo quando il comando genera un messaggio dettagliato.This parameter works only when the command generates a verbose message. Questo parametro, ad esempio, funziona quando un comando contiene il Write-Verbose cmdlet.For example, this parameter works when a command contains the Write-Verbose cmdlet.

Type: SwitchParameter
Aliases: vb

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Il parametro verbose esegue l'override del valore della $VerbosePreference variabile per il comando corrente.The Verbose parameter overrides the value of the $VerbosePreference variable for the current command. Poiché il valore predefinito della $VerbosePreference variabile è SilentlyContinue, i messaggi dettagliati non vengono visualizzati per impostazione predefinita.Because the default value of the $VerbosePreference variable is SilentlyContinue, verbose messages aren't displayed by default.

-Verbose:$true ha lo stesso effetto di -Verbose-Verbose:$true has the same effect as -Verbose

-Verbose:$false evita la visualizzazione dei messaggi dettagliati.-Verbose:$false suppresses the display of verbose messages. Usare questo parametro quando il valore di $VerbosePreference non è SilentlyContinue (impostazione predefinita).Use this parameter when the value of $VerbosePreference isn't SilentlyContinue (the default).

WarningActionWarningAction

Determina il modo in cui il cmdlet risponde a un avviso dal comando.Determines how the cmdlet responds to a warning from the command. Il valore predefinito è continue .Continue is the default value. Questo parametro funziona solo quando il comando genera un messaggio di avviso.This parameter works only when the command generates a warning message. Questo parametro, ad esempio, funziona quando un comando contiene il Write-Warning cmdlet.For example, this parameter works when a command contains the Write-Warning cmdlet.

Type: ActionPreference
Aliases: wa
Accepted values: Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue

Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

Il parametro WarningAction esegue l'override del valore della $WarningPreference variabile per il comando corrente.The WarningAction parameter overrides the value of the $WarningPreference variable for the current command. Poiché il valore predefinito della $WarningPreference variabile è continue, vengono visualizzati gli avvisi e l'esecuzione continua a meno che non si usi il parametro WarningAction .Because the default value of the $WarningPreference variable is Continue, warnings are displayed and execution continues unless you use the WarningAction parameter.

-WarningAction:Continue Visualizza i messaggi di avviso e continua l'esecuzione del comando.-WarningAction:Continue displays the warning messages and continues executing the command. Continue è l'impostazione predefinita.Continue is the default.

-WarningAction:Inquire Visualizza il messaggio di avviso e chiede conferma prima di continuare l'esecuzione.-WarningAction:Inquire displays the warning message and prompts you for confirmation before continuing execution. Questo valore viene usato raramente.This value is rarely used.

-WarningAction:SilentlyContinue Disattiva il messaggio di avviso e continua l'esecuzione del comando.-WarningAction:SilentlyContinue suppresses the warning message and continues executing the command.

-WarningAction:Stop Visualizza il messaggio di avviso e arresta l'esecuzione del comando.-WarningAction:Stop displays the warning message and stops executing the command.

Nota

Il parametro WarningAction esegue l'override di, ma non sostituisce il valore della $WarningAction variabile di preferenza quando il parametro viene usato in un comando per eseguire uno script o una funzione.The WarningAction parameter overrides, but does not replace the value of the $WarningAction preference variable when the parameter is used in a command to run a script or function.

WarningVariableWarningVariable

Archivia gli avvisi relativi al comando nella variabile specificata.Stores warnings about the command in the specified variable.

Type: String
Aliases: wv

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

Tutti gli avvisi generati vengono salvati nella variabile anche se gli avvisi non vengono visualizzati all'utente.All generated warnings are saved in the variable even if the warnings aren't displayed to the user.

Per aggiungere gli avvisi al contenuto della variabile, anziché sostituire gli avvisi che potrebbero essere già archiviati, digitare un segno più ( + ) prima del nome della variabile.To append the warnings to the variable content, instead of replacing any warnings that might already be stored there, type a plus sign (+) before the variable name.

Ad esempio, il comando seguente crea la $a variabile e quindi archivia eventuali avvisi:For example, the following command creates the $a variable and then stores any warnings in it:

Get-Process -Id 6 -WarningVariable a

Il comando seguente aggiunge tutti gli avvisi alla $a variabile:The following command adds any warnings to the $a variable:

Get-Process -Id 2 -WarningVariable +a

Il seguente comando Visualizza il contenuto di $a :The following command displays the contents of $a:

$a

È possibile usare questo parametro per creare una variabile che contiene solo avvisi da comandi specifici.You can use this parameter to create a variable that contains only warnings from specific commands. È possibile utilizzare la notazione di matrice, ad esempio $a[0] o, $warning[1,2] per fare riferimento a avvisi specifici archiviati nella variabile.You can use array notation, such as $a[0] or $warning[1,2] to refer to specific warnings stored in the variable.

Nota

La variabile Warning contiene tutti gli avvisi generati dal comando, inclusi gli avvisi provenienti da chiamate a funzioni o script annidati.The warning variable contains all warnings generated by the command, including warnings from calls to nested functions or scripts.

Descrizioni del parametro di gestione dei rischiRisk Management Parameter Descriptions

WhatIfWhatIf

Visualizza un messaggio che descrive l'effetto del comando, anziché eseguire il comando.Displays a message that describes the effect of the command, instead of executing the command.

Type: SwitchParameter
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Il parametro whatIf esegue l'override del valore della $WhatIfPreference variabile per il comando corrente.The WhatIf parameter overrides the value of the $WhatIfPreference variable for the current command. Poiché il valore predefinito della $WhatIfPreference variabile è 0 (disabilitato), il comportamento whatIf non viene eseguito senza il parametro whatIf .Because the default value of the $WhatIfPreference variable is 0 (disabled), WhatIf behavior isn't done without the WhatIf parameter. Per ulteriori informazioni, vedere about_Preference_VariablesFor more information, see about_Preference_Variables

-WhatIf:$true ha lo stesso effetto di -WhatIf .-WhatIf:$true has the same effect as -WhatIf.

-WhatIf:$false evita il comportamento WhatIf automatico risultante quando il valore della $WhatIfPreference variabile è 1.-WhatIf:$false suppresses the automatic WhatIf behavior that results when the value of the $WhatIfPreference variable is 1.

Ad esempio, il comando seguente usa il -WhatIf parametro in un Remove-Item comando:For example, the following command uses the -WhatIf parameter in a Remove-Item command:

Remove-Item Date.csv -WhatIf

Anziché rimuovere l'elemento, PowerShell elenca le operazioni da eseguire e gli elementi interessati.Instead of removing the item, PowerShell lists the operations it would do and the items that would be affected. Questo comando produce l'output seguente:This command produces the following output:

What if: Performing operation "Remove File" on
Target "C:\ps-test\date.csv".

ConfirmConfirm

Richiede la conferma dell'utente prima dell'esecuzione del comando.Prompts you for confirmation before executing the command.

Type: SwitchParameter
Aliases: cf

Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

Il parametro Confirm esegue l'override del valore della $ConfirmPreference variabile per il comando corrente.The Confirm parameter overrides the value of the $ConfirmPreference variable for the current command. Il valore predefinito è true.The default value is true. Per ulteriori informazioni, vedere about_Preference_VariablesFor more information, see about_Preference_Variables

-Confirm:$true ha lo stesso effetto di -Confirm .-Confirm:$true has the same effect as -Confirm.

-Confirm:$false Disattiva la conferma automatica, che si verifica quando il valore di $ConfirmPreference è minore o uguale al rischio stimato del cmdlet.-Confirm:$false suppresses automatic confirmation, which occurs when the value of $ConfirmPreference is less than or equal to the estimated risk of the cmdlet.

Ad esempio, il comando seguente usa il parametro Confirm con un Remove-Item comando.For example, the following command uses the Confirm parameter with a Remove-Item command. Prima di rimuovere l'elemento, PowerShell elenca le operazioni da eseguire e gli elementi interessati e richiede l'approvazione.Before removing the item, PowerShell lists the operations it would do and the items that would be affected, and asks for approval.

PS C:\ps-test> Remove-Item tmp*.txt -Confirm

Confirm
Are you sure you want to perform this action?
Performing operation "Remove File" on Target " C:\ps-test\tmp1.txt
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend
[?] Help (default is "Y"):

Le opzioni conferma risposta sono le seguenti:The Confirm response options are as follows:

RispostaResponse RisultatoResult
Sì (Y)Yes (Y) Eseguire l'azione.Perform the action.
Sì a tutti (A)Yes to All (A) Esegui tutte le azioni ed evita le successive query di confermaPerform all actions and suppress subsequent Confirm queries
per questo comando.for this command.
No (N):No (N): Non eseguire l'azione.Do not perform the action.
No a tutti (L):No to All (L): Non eseguire alcuna azione ed escludere la conferma successivaDo not perform any actions and suppress subsequent Confirm
esegue una query per questo comando.queries for this command.
Sospese:Suspend (S): Sospendere il comando e creare una sessione temporanea.Pause the command and create a temporary session.
Guida (?)Help (?) Visualizza la guida per queste opzioni.Display help for these options.

L'opzione Sospendi consente di posizionare il comando in attesa e di creare una sessione nidificata temporanea in cui è possibile lavorare fino a quando non si è pronti a scegliere un'opzione di conferma .The Suspend option places the command on hold and creates a temporary nested session in which you can work until you're ready to choose a Confirm option. Il prompt dei comandi per la sessione nidificata contiene due elementi di lavoro aggiuntivi (>>) per indicare che si tratta di un'operazione figlio del comando padre originale.The command prompt for the nested session has two extra carets (>>) to indicate that it's a child operation of the original parent command. È possibile eseguire comandi e script nella sessione nidificata.You can run commands and scripts in the nested session. Per terminare la sessione nidificata e tornare alle opzioni Confirm per il comando originale, digitare "Exit".To end the nested session and return to the Confirm options for the original command, type "exit".

Nell'esempio seguente vengono usate le opzioni di sospensione per arrestare temporaneamente un comando mentre l'utente controlla la guida per un parametro di comando.In the following example, the Suspend option (S) is used to halt a command temporarily while the user checks the help for a command parameter. Dopo aver ottenuto le informazioni necessarie, l'utente digita "Exit" per terminare il prompt annidato e quindi seleziona la risposta Yes (y) per la query Confirm.After obtaining the needed information, the user types "exit" to end the nested prompt and then selects the Yes (y) response to the Confirm query.

PS C:\ps-test> New-Item -ItemType File -Name Test.txt -Confirm

Confirm
Are you sure you want to perform this action?

Performing operation "Create File" on Target "Destination:
C:\ps-test\test.txt".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default
is "Y"): s

PS C:\ps-test> Get-Help New-Item -Parameter ItemType

-ItemType <string>
Specifies the provider-specified type of the new item.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       true (ByPropertyName)
Accept wildcard characters?  false

PS C:\ps-test> exit

Confirm
Are you sure you want to perform this action?
Performing operation "Create File" on Target "Destination: C:\ps-test\test
.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (defau
lt is "Y"): y

Directory: C:\ps-test

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
-a---         8/27/2010   2:41 PM          0 test.txt

ParoleKEYWORDS

about_Common_Parametersabout_Common_Parameters

VEDERE ANCHESEE ALSO

about_Preference_Variablesabout_Preference_Variables

Write-DebugWrite-Debug

Write-WarningWrite-Warning

Write-ErrorWrite-Error

Write-VerboseWrite-Verbose