Condividi tramite


about_Commonparameters

ARGOMENTO
    about_CommonParameters

DESCRIZIONE BREVE
    Descrive i parametri che possono essere utilizzati con qualsiasi 
    cmdlet.


DESCRIZIONE DETTAGLIATA
    I parametri comuni sono un set di parametri dei cmdlet che è possibile 
    utilizzare con qualsiasi cmdlet. Vengono implementati da Windows 
    PowerShell, non dallo sviluppatore di cmdlet, e sono automaticamente 
    disponibili per qualsiasi cmdlet.


    È possibile utilizzare i parametri comuni con qualsiasi cmdlet, ma 
    potrebbero non avere effetti su tutti i cmdlet. Se ad esempio un 
    cmdlet non genera alcun output dettagliato, l'utilizzo del parametro 
    comune Verbose non ha alcun effetto.


    Diversi parametri comuni eseguono l'override delle impostazioni 
    predefinite del sistema o delle preferenze impostate tramite le 
    variabili di preferenza di Windows PowerShell. A differenza delle 
    variabili di preferenza, i parametri comuni hanno effetto solo 
    sui comandi in cui vengono utilizzati.
 
    
    Oltre ai parametri comuni, molti cmdlet offrono i parametri di 
    attenuazione dei rischi WhatIf e Confirm. Solitamente i cmdlet che 
    comportano rischi per il sistema o per i dati dell'utente offrono questi 
    parametri.


    I parametri comuni sono i seguenti:


       -Verbose
       -Debug
       -WarningAction
       -WarningVariable
       -ErrorAction
       -ErrorVariable
       -OutVariable
       -OutBuffer  

 
    I parametri di attenuazione dei rischi sono:


       -WhatIf
       -Confirm


    Per ulteriori informazioni sulle variabili di preferenza, digitare:

  
       help about_preference_variables


  Descrizioni dei parametri comuni       

    -Verbose[:{$true | $false}]

        Vengono visualizzate le informazioni dettagliate sull'operazione 
        eseguita dal comando. Queste informazioni sono analoghe alle 
        informazioni in un'analisi o in un registro delle transazioni. Questo 
        parametro funziona solo quando il comando genera un messaggio 
        dettagliato, ad esempio quando un comando contiene il cmdlet 
        Write-Verbose.
        
        Il parametro Verbose esegue l'override del valore della variabile 
        $VerbosePreference per il comando corrente. Poiché il valore 
        predefinito della variabile $VerbosePreference è SilentlyContinue, i 
        messaggi dettagliati non vengono visualizzati per impostazione 
        predefinita.

        Valori validi:

            $true (-Verbose:$true) esercita lo stesso effetto di -Verbose.

            $false (-Verbose:$false) elimina la visualizzazione di 
            messaggi dettagliati. Utilizzare questo parametro quando 
            il valore di $VerbosePreference non è SilentlyContinue 
            (impostazione predefinita). 



    -Debug[:{$true | $false}]

        Vengono visualizzate informazioni a livello di programmazione 
        sull'operazione eseguita dal comando. Questo parametro funziona solo 
        quando il comando genera un messaggio di debug, ad esempio quando un 
        comando contiene il cmdlet Write-Debug.
    
        Il parametro Debug esegue l'override del valore della variabile 
        $DebugPreference per il comando corrente. Poiché il valore 
        predefinito della variabile $DebugPreference è SilentlyContinue, i 
        messaggi di debug non vengono visualizzati per impostazione predefinita.
       
        Valori validi:

            $true (-Debug:$true). Esercita lo stesso effetto di -Debug.

            $false (-Debug:$false). Elimina la visualizzazione di 
            messaggi di debug quando il valore di $DebugPreference non è 
            SilentlyContinue (impostazione predefinita). 



    -WarningAction[:{SilentlyContinue | Continue | Inquire | Stop}]  

        Determina la risposta del cmdlet a un avviso del comando.
        "Continue" è il valore predefinito. Questo parametro funziona solo 
        quando il comando genera un messaggio di avviso, ad esempio quando un 
        comando contiene il cmdlet Write-Warning.

        Il parametro WarningAction esegue l'override del valore della 
        variabile $WarningPreference per il comando corrente. Poiché 
        il valore predefinito della variabile $WarningPreference è 
        Continue, vengono visualizzati gli avvisi e l'esecuzione 
        continua a meno che non si utilizzi il parametro WarningAction. 

         Valori validi:

            SilentlyContinue. Elimina il messaggio di avviso e 
            l'esecuzione del comando continua.

            Continue. Visualizza il messaggio di avviso e l'esecuzione del 
            comando continua. "Continue" è il valore predefinito.
 
            Inquire. Visualizza il messaggio di avviso e richiede 
            all'utente la conferma prima di continuare l'esecuzione. 
            Questo valore viene utilizzato di rado.

            Stop. Visualizza il messaggio di avviso e interrompe 
            l'esecuzione del comando.



    -WarningVariable [+]<variable-name>

        Archivia gli avvisi relativi al comando nella variabile 
        specificata.

        Per aggiungere gli avvisi al contenuto della variabile, anziché 
        sostituire qualsiasi avviso che potrebbe essere già presente, 
        digitare un segno più (+) prima del nome della variabile. 

        Ad esempio, il comando seguente crea la variabile $a e 
        archivia in essa gli avvisi:

            get-process -id 6 -WarningVariable a  

        Con il comando seguente vengono aggiunti avvisi alla variabile $a:

            get-process -id 2 -WarningVariable +a 

        Con il comando seguente viene visualizzato il contenuto di $a:

            $a                                     

        È possibile utilizzare questo parametro per creare una 
        variabile che contiene solo gli avvisi di comandi specifici. 
        È possibile utilizzare una notazione di matrice, ad esempio 
        $a[0] o $warning[1,2], per fare riferimento ad avvisi specifici 
        archiviati nella variabile.


    -ErrorAction[:{SilentlyContinue | Continue | Inquire | Stop)]  

        Determina la risposta del cmdlet a un errore non fatale del 
        comando. Questo parametro funziona solo quando il comando 
        genera un messaggio di debug, ad esempio quando un comando 
        contiene il cmdlet Write-Error.

        Il parametro ErrorAction esegue l'override del valore della 
        variabile $ErrorActionPreference per il comando corrente. 
        Poiché il valore predefinito della variabile $ErrorActionPrefe
        rence è Continue, vengono visualizzati i messaggi di errore e 
        l'esecuzione continua a meno che non si utilizzi il parametro 
        ErrorAction. 

        Il parametro ErrorAction non ha effetto sugli errori fatali, 
        ad esempio dati mancanti, parametri non validi o autorizzazioni 
        insufficienti, che impediscono il completamento corretto di un comando.

        Valori validi:

            SilentlyContinue. Elimina il messaggio di errore e 
            l'esecuzione del comando continua.

            Continue. Visualizza il messaggio di errore e l'esecuzione del 
            comando continua. "Continue" è il valore predefinito.
 
            Inquire. Visualizza il messaggio di errore e richiede 
            all'utente la conferma prima di continuare l'esecuzione. 
            Questo valore viene utilizzato di rado.

            Stop. Viene visualizzato il messaggio di errore e 
            l'esecuzione del comando viene arrestata.

            
    -ErrorVariable [+]<nome-variabile>

        Archivia i messaggi di errore relativi al comando nella variabile 
        specificata e nella variabile automatica $Error. Per ulteriori 
        informazioni, digitare il comando seguente:

            get-help about_automatic_variables

        Per impostazione predefinita, i nuovi messaggi di errore 
        sovrascrivono i messaggi di errore già archiviati nella 
        variabile. Per aggiungere il messaggio di errore al contenuto 
        della variabile, digitare un segno più (+) prima del nome della 
        variabile. 

        Ad esempio, il comando seguente crea la variabile $a e 
        archivia in essa gli errori:

            get-process -id 6 -ErrorVariable a

        Con il comando seguente vengono aggiunti messaggi di errore alla 
        variabile $a:


            get-process -id 2 -ErrorVariable +a

        Con il comando seguente viene visualizzato il contenuto di $a:

            $a                                     

        È possibile utilizzare questo parametro per creare una 
        variabile che contiene solo i messaggi di errore di comandi 
        specifici. La variabile automatica $Error contiene messaggi 
        di errore di tutti i comandi della sessione.
        È possibile utilizzare una notazione di matrice, ad esempio 
        $a[0] o $error[1,2], per fare riferimento a errori specifici 
        archiviati nelle variabili.


    -OutVariable [+]<nome-variabile>

        Archivia oggetti di output dal comando nella variabile 
        specificata e vengono visualizzati sulla riga di comando.

        Per aggiungere l'output alla variabile, anziché sostituire 
        l'output che potrebbe essere già presente, digitare un segno 
        più (+) prima del nome della variabile. 

        Ad esempio, il comando seguente crea la variabile $out e 
        archivia in essa l'oggetto processo:

            get-process powershell -OutVariable out   

        Con il comando seguente viene aggiunto l'oggetto processo 
        alla variabile $out:

            get-process iexplore -OutVariable +out 

        Nel comando seguente viene visualizzato il contenuto della 
        variabile $out:

            $out                                         


    -OutBuffer <Int32>

        Determina il numero di oggetti da accumulare in un buffer 
        prima che venga inviato qualsiasi oggetto attraverso la 
        pipeline. Se si omette questo parametro, gli oggetti vengono 
        inviati al momento della generazione. 

        Questo parametro di gestione delle risorse è progettato per 
        gli utenti avanzati. Quando si utilizza questo parametro, 
        Windows PowerShell non chiama il cmdlet successivo nella 
        pipeline finché il numero di oggetti generati non è uguale 
        a OutBuffer + 1. Successivamente, invia tutti gli oggetti 
        al momento della generazione.

        
  Descrizioni del parametro di gestione dei rischi         
    -WhatIf[:{$true | $false}]
        Visualizza un messaggio che descrive l'effetto del comando anziché 
        eseguirlo.

        Il parametro WhatIf esegue l'override del valore della variabile 
        $WhatIfPreference per il comando corrente. Poiché il valore 
        predefinito della variabile $WhatIfPreference è 0 (disabilitata), il comportamento WhatIf non viene eseguito senza il parametro WhatIf. 
        Per ulteriori informazioni, digitare il comando seguente:

            get-help about_preference_variables



        Valori validi:

            $true (-WhatIf:$true). Esercita lo stesso effetto di -
            WhatIf.           
            $false (-WhatIf:$false). Elimina il comportamento 
            automatico WhatIf che si verifica quando il valore della 
            variabile $WhatIfPreference è 1. 

        Ad esempio, il comando seguente utilizza il parametro WhatIf in un 
        comando Remove-Item:

            PS> remove-item date.csv -whatif

        Anziché rimuovere l'elemento, Windows PowerShell elenca le 
        operazioni che verrebbero eseguite e gli elementi su cui avrebbero 
        effetto. Questo comando produce l'output seguente:

            What if: Esecuzione dell'operazione "Remove File" sulla 
            destinazione "C:\ps-test\date.csv".

        
    -Confirm[:{$true | $false}]
        Chiede una conferma prima di eseguire il comando.

        Il parametro Confirm esegue l'override del valore della variabile 
        $ConfirmPreference per il comando corrente. Il valore predefinito è 
        High. Per ulteriori informazioni, digitare il comando seguente:

            get-help about_preference_variables 
        Valori validi:

            $true (-WhatIf:$true). Esercita lo stesso effetto di 
            -Confirm.          

            $false(-Confirm:$false). Elimina la conferma automatica che si 
            verifica quando il valore di $ConfirmPreference è minore o uguale al 
            rischio previsto del cmdlet. 

        Ad esempio, il comando seguente utilizza il parametro Confirm 
        con un comando Remove-Item. Prima di rimuovere l'elemento, Windows 
        PowerShell elenca le operazioni che verrebbero eseguite e gli 
        elementi su cui avrebbero effetto.

            PS C:\ps-test> remove-item tmp*.txt -confirm

        Questo comando produce l'output seguente:

            Confirm
            Eseguire l'operazione?
            Esecuzione dell'operazione "Remove File" sulla 
            destinazione " C:\ps-test\tmp1.txt [Y] Sì [A] Sì a tutti 
            [N] No [L] No a tutti [S] Sospendi [?] Guida (il valore 
            predefinito è "S"):


VEDERE ANCHE
    about_Preference_Variables
    Write-Debug
    Write-Warning
    Write-Error
    Write-Verbose