about_CommonParameters

Krótki opis

Opisuje parametry, które mogą być używane z dowolnym poleceniem cmdlet.

Długi opis

Typowe parametry to zestaw parametrów polecenia cmdlet, których można używać z dowolnym poleceniem cmdlet. Są one implementowane przez program PowerShell, a nie przez dewelopera poleceń cmdlet i są automatycznie dostępne dla dowolnego polecenia cmdlet.

Możesz użyć typowych parametrów z dowolnym poleceniem cmdlet, ale mogą nie mieć wpływu na wszystkie polecenia cmdlet. Jeśli na przykład polecenie cmdlet nie generuje żadnych pełnych danych wyjściowych, użycie wspólnego parametru Verbose nie ma żadnego efektu.

Typowe parametry są również dostępne w funkcjach zaawansowanych, które używają atrybutu CmdletBinding lub atrybutu Parameter .

Kilka typowych parametrów zastępuje domyślne ustawienia systemowe lub preferencje ustawione przy użyciu zmiennych preferencji programu PowerShell. W przeciwieństwie do zmiennych preferencji wspólne parametry mają wpływ tylko na polecenia, w których są używane.

Aby uzyskać więcej informacji, zobacz about_Preference_Variables.

Poniższa lista zawiera typowe parametry. Ich aliasy są wymienione w nawiasach.

  • Debug (db)
  • ErrorAction (ea)
  • ErrorVariable (ev)
  • InformationAction (infa)
  • InformationVariable (iv)
  • OutVariable (ov)
  • OutBuffer (ob)
  • PipelineVariable (pv)
  • Verbose (vb)
  • WarningAction (wa)
  • WarningVariable (wv)

Parametry akcji to wartości typu ActionPreference . ActionPreference to wyliczenie z następującymi wartościami:

Nazwa Wartość
Break 6
Suspend 5
Ignore 4
Inquire 3
Continue 2
Stop 1
SilentlyContinue 0

Możesz użyć nazwy lub wartości z parametrem .

Oprócz typowych parametrów wiele poleceń cmdlet oferuje parametry ograniczania ryzyka. Polecenia cmdlet, które wiążą się z ryzykiem dla systemu lub danych użytkownika, zwykle oferują te parametry.

Parametry ograniczania ryzyka to:

  • WhatIf (wi)
  • Confirm (cf)

Typowe opisy parametrów

-Debug

Wyświetla szczegółowe informacje o operacji wykonywanej przez polecenie . Ten parametr działa tylko wtedy, gdy polecenie generuje komunikat debugowania. Na przykład ten parametr działa, gdy polecenie zawiera Write-Debug polecenie cmdlet.

Type: SwitchParameter
Aliases: db

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

Domyślnie komunikaty debugowania nie są wyświetlane, ponieważ wartość zmiennej $DebugPreference to SilentlyContinue.

W trybie Debug interaktywnym parametr zastępuje wartość $DebugPreference zmiennej dla bieżącego polecenia, ustawiając wartość $DebugPreference na Inquire.

W trybie Debug nieinterakcyjnym parametr zastępuje wartość $DebugPreference zmiennej dla bieżącego polecenia, ustawiając wartość na $DebugPreferenceKontynuuj.

-Debug:$true ma taki sam efekt jak -Debug. Służy -Debug:$false do pomijania wyświetlania komunikatów debugowania, gdy $DebugPreference wartość nie jest dyskretniekontynujna, co jest ustawieniem domyślnym.

-ErrorAction

Określa, w jaki sposób polecenie cmdlet reaguje na błąd niepowodujący zakończenia polecenia. Ten parametr działa tylko wtedy, gdy polecenie generuje błąd niepowodujący zakończenia, taki jak te z Write-Error polecenia cmdlet.

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

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

Parametr ErrorAction zastępuje wartość $ErrorActionPreference zmiennej dla bieżącego polecenia. Ponieważ domyślną wartością zmiennej $ErrorActionPreference jest Kontynuuj, są wyświetlane komunikaty o błędach i wykonywanie będzie kontynuowane, chyba że zostanie użyty parametr ErrorAction .

Parametr ErrorAction nie ma wpływu na błędy zakończenia (takie jak brakujące dane, parametry, które nie są prawidłowe lub niewystarczające uprawnienia), które uniemożliwiają pomyślne ukończenie polecenia.

-ErrorAction:Break Wprowadza debuger w przypadku wystąpienia błędu lub zgłoszenia wyjątku.

-ErrorAction:Continue Wyświetla komunikat o błędzie i kontynuuje wykonywanie polecenia. Wartość domyślna to Continue.

-ErrorAction:Ignore Pomija komunikat o błędzie i kontynuuje wykonywanie polecenia. W przeciwieństwie do funkcji SilentlyContinue funkcja Ignore nie dodaje komunikatu o błędzie do zmiennej automatycznej $Error . Wartość Ignore jest wprowadzana w programie PowerShell 3.0.

-ErrorAction:Inquire Wyświetla komunikat o błędzie i monituje o potwierdzenie przed kontynuowaniem wykonywania. Ta wartość jest rzadko używana.

-ErrorAction:SilentlyContinue Pomija komunikat o błędzie i kontynuuje wykonywanie polecenia.

-ErrorAction:Stop Wyświetla komunikat o błędzie i zatrzymuje wykonywanie polecenia.

-ErrorAction:Suspend Jest dostępny tylko w przypadku przepływów pracy, które nie są obsługiwane w programie PowerShell 6 lub nowszym.

Uwaga

Parametr ErrorAction zastępuje, ale nie zastępuje wartości $ErrorActionPreference zmiennej, gdy parametr jest używany w poleceniu do uruchamiania skryptu lub funkcji.

-ErrorVariable

ErrorVariable przechowuje komunikaty o błędach dotyczące polecenia w określonej zmiennej i w zmiennej automatycznej $Error . Aby uzyskać więcej informacji, zobacz about_Automatic_Variables

Type: String
Aliases: ev

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

Domyślnie nowe komunikaty o błędach zastępują komunikaty o błędach, które są już przechowywane w zmiennej. Aby dołączyć komunikat o błędzie do zawartości zmiennej, wpisz znak plus (+) przed nazwą zmiennej.

Na przykład następujące polecenie tworzy zmienną $a , a następnie przechowuje w niej błędy:

Get-Process -Id 6 -ErrorVariable a

Następujące polecenie dodaje do zmiennej wszelkie komunikaty o błędach $a :

Get-Process -Id 2 -ErrorVariable +a

Następujące polecenie wyświetla zawartość elementu $a:

$a

Tego parametru można użyć do utworzenia zmiennej zawierającej tylko komunikaty o błędach z określonych poleceń i nie ma wpływu na zachowanie zmiennej automatycznej $Error . Zmienna automatyczna $Error zawiera komunikaty o błędach ze wszystkich poleceń w sesji. Możesz użyć notacji tablicowej, takiej jak $a[0] lub $error[1,2] , aby odwoływać się do określonych błędów przechowywanych w zmiennych.

Uwaga

Niestandardowa zmienna błędu zawiera wszystkie błędy generowane przez polecenie, w tym błędy z wywołań do zagnieżdżonych funkcji lub skryptów.

-InformationAction

Wprowadzono w programie PowerShell 5.0. W poleceniu lub skrycie, w którym jest używany, wspólny parametr InformationAction zastępuje wartość $InformationPreference zmiennej preferencji, która domyślnie jest ustawiona na SilentlyContinue. W przypadku użycia Write-Information w skry skrycie z funkcją InformationActionWrite-Information wartości są wyświetlane w zależności od wartości parametru InformationAction. Aby uzyskać więcej informacji na temat $InformationPreferenceprogramu , zobacz about_Preference_Variables.

Type: ActionPreference
Aliases: ia
Accepted values: Break, 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:Break Wprowadza debuger w wystąpieniu Write-Information polecenia .

-InformationAction:Stop zatrzymuje polecenie lub skrypt w wystąpieniu Write-Information polecenia.

-InformationAction:Ignore Pomija komunikat informacyjny i kontynuuje uruchamianie polecenia. W przeciwieństwie do silentlyContinue, Ignoruj całkowicie zapomina o wiadomości informacyjnej; nie dodaje komunikatu informacyjnego do strumienia informacji.

-InformationAction:Inquire Wyświetla komunikat informacyjny określony w poleceniu Write-Information , a następnie pyta, czy chcesz kontynuować.

-InformationAction:Continue wyświetla komunikat informacyjny i kontynuuje działanie.

-InformationAction:Suspend program nie jest obsługiwany w programie PowerShell 6 lub nowszym, ponieważ jest dostępny tylko dla przepływów pracy.

-InformationAction:SilentlyContinue brak efektu, ponieważ komunikat informacyjny nie jest wyświetlany (wartość domyślna), a skrypt będzie kontynuowany bez przerwy.

Uwaga

Parametr InformationAction zastępuje, ale nie zastępuje wartości $InformationAction zmiennej preferencji, gdy parametr jest używany w poleceniu do uruchamiania skryptu lub funkcji.

-InformationVariable

Wprowadzono w programie PowerShell 5.0. W poleceniu lub skrypcie, w którym jest używany, wspólny parametr InformationVariable przechowuje w zmiennej ciąg określony przez dodanie Write-Information polecenia. Write-Information wartości są wyświetlane w zależności od wartości wspólnego parametru InformationAction ; Jeśli nie dodasz wspólnego parametru InformationAction , Write-Information ciągi są wyświetlane w zależności od wartości zmiennej $InformationPreference preferencji. Aby uzyskać więcej informacji na temat $InformationPreferenceprogramu , zobacz about_Preference_Variables.

Uwaga

Zmienna informacyjna zawiera wszystkie komunikaty informacyjne generowane przez polecenie, w tym komunikaty informacyjne z wywołań do zagnieżdżonych funkcji lub skryptów.

Type: String
Aliases: iv

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

-OutBuffer

Określa liczbę obiektów do gromadzenia się w buforze, zanim jakiekolwiek obiekty zostaną wysłane przez potok. W przypadku pominięcia tego parametru obiekty są wysyłane podczas ich generowania.

Type: Int32
Aliases: ob

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

Ten parametr zarządzania zasobami jest przeznaczony dla zaawansowanych użytkowników. W przypadku użycia tego parametru program PowerShell wysyła dane do następnego polecenia cmdlet w partiach OutBuffer + 1.

W poniższym przykładzie są wyświetlane alternatywne opcje między ForEach-Object blokami przetwarzania Write-Host , które używają polecenia cmdlet. Wyświetlanie alternatywnych w partiach 2 lub 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

-OutVariable

Przechowuje obiekty wyjściowe z polecenia w określonej zmiennej oprócz wysyłania danych wyjściowych wzdłuż potoku.

Type: String
Aliases: ov

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

Aby dodać dane wyjściowe do zmiennej, zamiast zastępować wszystkie dane wyjściowe, które mogą być już tam przechowywane, wpisz znak plus (+) przed nazwą zmiennej.

Na przykład następujące polecenie tworzy zmienną $out i przechowuje w nim obiekt procesu:

Get-Process PowerShell -OutVariable out

Następujące polecenie dodaje obiekt procesu do zmiennej $out :

Get-Process iexplore -OutVariable +out

Następujące polecenie wyświetla zawartość zmiennej $out :

$out

Uwaga

Zmienna utworzona przez parametr OutVariable to [System.Collections.ArrayList].

-PipelineVariable

PipelineVariable umożliwia dostęp do najnowszej wartości przekazanej do następnego segmentu potoku za pomocą polecenia, które używa tego parametru. Dowolne polecenie w potoku może uzyskać dostęp do wartości przy użyciu nazwy PipelineVariable. Wartość jest przypisywana do zmiennej po przekazaniu jej do następnego segmentu potoku. Dzięki temu funkcja PipelineVariable jest łatwiejsza niż określona zmienna tymczasowa, która może być potrzebna do przypisania w wielu lokalizacjach.

W przeciwieństwie $_ do metody lub $PSItemużycie elementu PipelineVariable umożliwia dowolne polecenie potoku uzyskiwanie dostępu do wartości potoku przekazanych (i zapisanych) za pomocą poleceń innych niż bezpośrednio poprzedzające polecenie. Polecenia potoku mogą uzyskiwać dostęp do ostatniej wartości potokowej podczas przetwarzania następnego elementu przechodzącego przez potok. Dzięki temu polecenie może przywrócić dane wyjściowe do poprzedniego polecenia (lub samego).

Uwaga

Funkcje zaawansowane mogą mieć maksymalnie trzy bloki skryptów: begin, processi end. W przypadku używania parametru PipelineVariable z funkcjami zaawansowanymi tylko wartości z pierwszego zdefiniowanego bloku skryptu są przypisywane do zmiennej podczas uruchamiania funkcji. Aby uzyskać więcej informacji, zobacz Funkcje zaawansowane. Program PowerShell 7.2 poprawia to zachowanie.

Type: String
Aliases: pv

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

Prawidłowe wartości to ciągi, takie same jak w przypadku wszystkich nazw zmiennych.

Przestroga

Wartość PipelineVariable jest ograniczona do potoku, w którym jest wywoływana. Zmienne poza potokiem, które używają tej samej nazwy, są usuwane przed wykonaniem potoku. Element PipelineVariable wykracza poza zakres po zakończeniu potoku. Jeśli wiele poleceń w potoku określ tę samą wartość PipelineVariable , istnieje tylko jedna zmienna udostępniona. Ta zmienna jest aktualizowana przy użyciu najnowszych danych wyjściowych potokowych z polecenia, które określa zmienną.

Niektóre polecenia blokujące zbierają wszystkie elementy potoku przed uzyskaniem jakichkolwiek danych wyjściowych, na przykład Sort-Object lub Select-Object -Last. Dowolna wartość PipelineVariable przypisana w poleceniu przed takim poleceniem blokującym zawsze zawiera ostatni element potokowy z poprzedniego polecenia, gdy jest używany w poleceniu blokującym.

Poniżej przedstawiono przykład działania elementu PipelineVariable . W tym przykładzie parametr PipelineVariable jest dodawany do Foreach-Object polecenia w celu przechowywania wyników polecenia w zmiennych. Zakres liczb, od 1 do 5, są przesyłane potokiem do pierwszego Foreach-Object polecenia, z których wyniki są przechowywane w zmiennej o nazwie $temp.

Wyniki pierwszego Foreach-Object polecenia są przesyłane potokiem do drugiego Foreach-Object polecenia, które wyświetla bieżące wartości $temp i $_.

# Create a variable named $temp
$temp=8
Get-Variable temp
# Note that the variable just created is not available on the
# pipeline when -PipelineVariable creates the same variable name
1..5 | ForEach-Object -PipelineVariable temp -Begin {
    Write-Host "Step1[BEGIN]:`$temp=$temp"
} -Process {
  Write-Host "Step1[PROCESS]:`$temp=$temp - `$_=$_"
  Write-Output $_
} | ForEach-Object {
  Write-Host "`tStep2[PROCESS]:`$temp=$temp - `$_=$_"
}
# The $temp variable is deleted when the pipeline finishes
Get-Variable temp
Name                           Value
----                           -----
temp                           8

Step1[BEGIN]:$temp=
Step1[PROCESS]:$temp= - $_=1
        Step2[PROCESS]:$temp=1 - $_=1
Step1[PROCESS]:$temp=1 - $_=2
        Step2[PROCESS]:$temp=2 - $_=2
Step1[PROCESS]:$temp=2 - $_=3
        Step2[PROCESS]:$temp=3 - $_=3
Step1[PROCESS]:$temp=3 - $_=4
        Step2[PROCESS]:$temp=4 - $_=4
Step1[PROCESS]:$temp=4 - $_=5
        Step2[PROCESS]:$temp=5 - $_=5

Get-Variable: Cannot find a variable with the name 'temp'.

-Verbose

Wyświetla szczegółowe informacje o operacji wykonanej przez polecenie. Te informacje przypominają informacje w śladzie lub w dzienniku transakcji. Ten parametr działa tylko wtedy, gdy polecenie generuje pełny komunikat. Na przykład ten parametr działa, gdy polecenie zawiera Write-Verbose polecenie cmdlet.

Type: SwitchParameter
Aliases: vb

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

Parametr Verbose zastępuje wartość zmiennej $VerbosePreference dla bieżącego polecenia. Ponieważ domyślna wartość zmiennej $VerbosePreference to SilentlyContinue, pełne komunikaty nie są domyślnie wyświetlane.

-Verbose:$true ma taki sam efekt jak -Verbose

-Verbose:$false pomija wyświetlanie pełnych komunikatów. Użyj tego parametru, gdy wartość parametru $VerbosePreference nie jest dyskretniecontinue (wartość domyślna).

-WarningAction

Określa, jak polecenie cmdlet reaguje na ostrzeżenie z polecenia . Kontynuuj jest wartością domyślną. Ten parametr działa tylko wtedy, gdy polecenie generuje komunikat ostrzegawczy. Na przykład ten parametr działa, gdy polecenie zawiera Write-Warning polecenie cmdlet.

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

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

Parametr WarningAction zastępuje wartość zmiennej $WarningPreference dla bieżącego polecenia. Ponieważ wartość domyślna zmiennej $WarningPreference to Kontynuuj, ostrzeżenia są wyświetlane i wykonywanie będzie kontynuowane, chyba że używasz parametru WarningAction .

-WarningAction:Break wprowadza debuger po wystąpieniu ostrzeżenia.

-WarningAction:Continue wyświetla komunikaty ostrzegawcze i kontynuuje wykonywanie polecenia. Wartość domyślna to Continue.

-WarningAction:Inquire wyświetla komunikat ostrzegawczy i monituje o potwierdzenie przed kontynuowaniem wykonywania. Ta wartość jest rzadko używana.

-WarningAction:SilentlyContinue pomija komunikat ostrzegawczy i kontynuuje wykonywanie polecenia.

-WarningAction:Stop wyświetla komunikat ostrzegawczy i zatrzymuje wykonywanie polecenia.

Uwaga

Przesłonięcia parametru WarningAction , ale nie zastępuje wartości $WarningAction zmiennej preferencji, gdy parametr jest używany w poleceniu do uruchamiania skryptu lub funkcji.

-WarningVariable

Przechowuje ostrzeżenia dotyczące polecenia w określonej zmiennej.

Type: String
Aliases: wv

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

Wszystkie wygenerowane ostrzeżenia są zapisywane w zmiennej, nawet jeśli ostrzeżenia nie są wyświetlane użytkownikowi.

Aby dołączyć ostrzeżenia do zawartości zmiennej, zamiast zastępować wszelkie ostrzeżenia, które mogą być już tam przechowywane, wpisz znak plus (+) przed nazwą zmiennej.

Na przykład następujące polecenie tworzy zmienną $a , a następnie przechowuje w niej wszelkie ostrzeżenia:

Get-Process -Id 6 -WarningVariable a

Następujące polecenie dodaje wszelkie ostrzeżenia do zmiennej $a :

Get-Process -Id 2 -WarningVariable +a

Następujące polecenie wyświetla zawartość elementu $a:

$a

Tego parametru można użyć do utworzenia zmiennej zawierającej tylko ostrzeżenia z określonych poleceń. Możesz użyć notacji tablicy, takiej jak $a[0] lub $warning[1,2] odwołać się do określonych ostrzeżeń przechowywanych w zmiennej.

Uwaga

Zmienna ostrzegawcza zawiera wszystkie ostrzeżenia generowane przez polecenie, w tym ostrzeżenia z wywołań do zagnieżdżonych funkcji lub skryptów.

Opisy parametrów zarządzania ryzykiem

-WhatIf

Wyświetla komunikat opisujący efekt polecenia zamiast wykonywania polecenia.

Type: SwitchParameter
Aliases: wi

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

Parametr WhatIf zastępuje wartość zmiennej $WhatIfPreference dla bieżącego polecenia. Ponieważ wartość domyślna zmiennej $WhatIfPreference to 0 (wyłączone), zachowanie WhatIf nie jest wykonywane bez parametru WhatIf . Aby uzyskać więcej informacji, zobacz about_Preference_Variables

-WhatIf:$true ma taki sam efekt jak -WhatIf.

-WhatIf:$false pomija automatyczne zachowanie WhatIf, które powoduje, gdy wartość zmiennej $WhatIfPreference wynosi 1.

Na przykład następujące polecenie używa parametru -WhatIf w Remove-Item poleceniu:

Remove-Item Date.csv -WhatIf

Zamiast usuwać element, program PowerShell wyświetla listę operacji, których dotyczy, i elementów, których dotyczy problem. To polecenie generuje następujące dane wyjściowe:

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

-Confirm

Monituje o potwierdzenie przed wykonaniem polecenia.

Type: SwitchParameter
Aliases: cf

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

Parametr Confirm zastępuje wartość zmiennej $ConfirmPreference dla bieżącego polecenia. Wartością domyślną jest true. Aby uzyskać więcej informacji, zobacz about_Preference_Variables

-Confirm:$true ma taki sam efekt jak -Confirm.

-Confirm:$false pomija automatyczne potwierdzenie, które występuje, gdy wartość wartości $ConfirmPreference jest mniejsza lub równa szacowanemu ryzyku polecenia cmdlet.

Na przykład następujące polecenie używa parametru Confirm z poleceniem Remove-Item . Przed usunięciem elementu program PowerShell wyświetla listę operacji, których dotyczy, oraz elementów, których dotyczy problem, oraz monituje o zatwierdzenie.

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"):

Opcje Confirm odpowiedzi są następujące:

Reakcja Wynik
Yes (Y) Wykonaj akcję.
Yes to All (A) Wykonywanie wszystkich akcji i pomijanie kolejnych Confirm zapytań
dla tego polecenia.
No (N): Nie wykonuj akcji.
No to All (L): Nie wykonuj żadnych akcji i pomijaj kolejne Confirm
kwerendy dla tego polecenia.
Suspend (S): Wstrzymaj polecenie i utwórz sesję tymczasową.
Help (?) Wyświetl pomoc dotyczącą tych opcji.

Opcja Wstrzymaj powoduje wstrzymanie polecenia i tworzy tymczasową sesję Confirm zagnieżdżona, w której można pracować, dopóki nie będzie można wybrać opcji. Wiersz polecenia dla zagnieżdżonej sesji ma dwa dodatkowe daszki (>>), aby wskazać, że jest to podrzędna operacja oryginalnego polecenia nadrzędnego. Polecenia i skrypty można uruchamiać w sesji zagnieżdżonej. Aby zakończyć sesję zagnieżdżoną i powrócić do Confirm opcji oryginalnego polecenia, wpisz "exit".

W poniższym przykładzie opcja Wstrzymanie (S) jest używana do tymczasowego zatrzymania polecenia, gdy użytkownik sprawdza pomoc dla parametru polecenia. Po uzyskaniu wymaganych informacji użytkownik wpisze "exit", aby zakończyć zagnieżdżony monit, a następnie wybiera odpowiedź Tak (y) na Confirm zapytanie.

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

Słowa kluczowe

about_Common_Parameters

Zobacz też