Udostępnij za pośrednictwem

about_CommonParameters

  • Artykuł

Krótki opis

Opisuje parametry, których można używać 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ą one automatycznie dostępne dla dowolnego polecenia cmdlet.

Można 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 danych wyjściowych verbose , 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 . W przypadku używania tych atrybutów program PowerShell automatycznie dodaje parametry wspólne. Nie można utworzyć żadnych parametrów, które używają tych samych nazw co common parameters.

Kilka typowych parametrów zastępuje wartości domyślne systemu 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)
  • Odchylenie odchylne (ov)
  • OutBuffer (ob)
  • PipelineVariable (pv)
  • ProgressAction (proga)
  • Verbose (vb)
  • WarningAction (wa)
  • WarningVariable (wv)

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

Nazwa/nazwisko Wartość
Break 6
Suspend 5
Ignore 100
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ść $DebugPreference zmiennej to SilentlyContinue.

Parametr Debug zastępuje wartość $DebugPreference zmiennej dla bieżącego polecenia, ustawiając wartość na $DebugPreference Kontynuuj.

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

-ErrorAction

Określa, w jaki sposób polecenie cmdlet reaguje na błąd, który nie kończy się z polecenia . Ten parametr działa tylko wtedy, gdy polecenie generuje błąd niepowodujący zakończenia, taki jak ten 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ż wartość domyślna zmiennej $ErrorActionPreference to Kontynuuj, komunikaty o błędach są wyświetlane i wykonywanie będzie kontynuowane, chyba że używasz parametru 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.

  • Break Wprowadza debuger, gdy wystąpi błąd lub zostanie zgłoszony wyjątek.
  • Continue Wyświetla komunikat o błędzie i kontynuuje wykonywanie polecenia. Wartość domyślna to Continue.
  • 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.
  • Inquire Wyświetla komunikat o błędzie i monituje o potwierdzenie przed kontynuowaniem wykonywania. Ta wartość jest rzadko używana.
  • SilentlyContinue pomija komunikat o błędzie i kontynuuje wykonywanie polecenia.
  • Stop Wyświetla komunikat o błędzie i zatrzymuje wykonywanie polecenia.
  • Suspend jest dostępny tylko dla przepływów pracy, które nie są obsługiwane w programie PowerShell 6 i poza nią.

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

Rekordy błędów są automatycznie przechowywane w zmiennej automatycznej $Error . Aby uzyskać więcej informacji, zobacz about_Automatic_Variables.

W przypadku używania parametru ErrorVariable w poleceniu program PowerShell przechowuje również rekordy błędów emitowane przez polecenie w zmiennej określonej przez parametr .

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, przed nazwą zmiennej umieść znak plus (+).

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

Get-Process -Id 6 -ErrorVariable a

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

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 ma wartość 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: infa
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
  • Break Wprowadza debuger w wystąpieniu Write-Information polecenia .
  • Stop zatrzymuje polecenie lub skrypt w wystąpieniu Write-Information polecenia.
  • Ignore pomija komunikat informacyjny i kontynuuje uruchamianie polecenia. W przeciwieństwie do silentlyContinue, Ignoruj całkowicie zapomina o komunikacie informacyjnym; nie dodaje komunikatu informacyjnego do strumienia informacji.
  • Inquire Wyświetla komunikat informacyjny określony w Write-Information poleceniu, a następnie, czy chcesz kontynuować.
  • Continue wyświetla komunikat informacyjny i kontynuuje działanie.
  • Suspend program Nie jest obsługiwany w programie PowerShell 6 i nowszym, ponieważ jest dostępny tylko dla przepływów pracy.
  • 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 przypadku używania wspólnego parametru InformationVariable rekordy informacji są przechowywane w zmiennej określonej przez parametr . Polecenie cmdlet programu PowerShell może zapisywać rekordy informacji w strumieniu informacji . Możesz również użyć Write-Information polecenia cmdlet , aby zapisać rekordy informacji.

Rekordy informacji są domyślnie wyświetlane jako komunikaty w konsoli programu . Wyświetlanie rekordu informacji można kontrolować przy użyciu wspólnego parametru InformationAction . Zachowanie można również zmienić przy użyciu 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

Domyślnie nowy rekord informacji zastępuje wartości, które są już przechowywane w zmiennej. Aby dołączyć komunikat o błędzie do zawartości zmiennej, przed nazwą zmiennej umieść znak plus (+).

-OutBuffer

Określa liczbę obiektów do gromadzenia się w buforze przed wysłaniem jakichkolwiek obiektów przez potok. Jeśli pominięto ten parametr, 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. Gdy używasz 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 niej 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

Funkcja PipelineVariable umożliwia dostęp do najnowszej wartości przekazanej do następnego segmentu potoku za pomocą polecenia używającego 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ć konieczna 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 przekazywanych (i zapisanych) za pomocą poleceń innych niż bezpośrednio poprzednie polecenie. Polecenia potoku mogą uzyskiwać dostęp do ostatniej wartości przesyłanej potokiem 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 siebie).

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 nazw zmiennych.

Uwaga

Wartość PipelineVariable jest ograniczona do potoku, w którym jest wywoływany. Zmienne poza potokiem, które używają tej samej nazwy, są czyszczone przed wykonaniem potoku. Wartość PipelineVariable wykracza poza zakres po zakończeniu potoku. Jeśli wiele poleceń w potoku określ tę samą zmienną PipelineVariable , istnieje tylko jedna współdzielona zmienna. Ta zmienna jest aktualizowana przy użyciu najnowszych potokowych danych wyjściowych 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. Każdy element PipelineVariable przypisany w poleceniu przed takim poleceniem blokującym zawsze zawiera ostatni element potokowy z poprzedniego polecenia, gdy jest używany w poleceniu po zablokowaniu polecenia.

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 isn't 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

Name                           Value
----                           -----
temp

-ProgressAction

Określa sposób reagowania programu PowerShell na aktualizacje postępu generowane przez skrypt, polecenie cmdlet lub dostawcę, takie jak paski postępu generowane przez polecenie cmdlet Write-Progress . Polecenie Write-Progress cmdlet tworzy paski postępu, które pokazują stan polecenia. Parametr ProgressAction został dodany w programie PowerShell 7.4.

Parametr ProgressAction przyjmuje jedną z ActionPreference wartości wyliczenia: SilentlyContinue, , Stop, IgnoreSuspendContinueInquirelub .Break

Prawidłowe wartości są następujące:

  • Break Wprowadza debuger w wystąpieniu Write-Progress polecenia .
  • Stop: nie wyświetla paska postępu. Zamiast tego wyświetla komunikat o błędzie i zatrzymuje wykonywanie.
  • Inquire: nie wyświetla paska postępu. Monituje o uprawnienie do kontynuowania. Jeśli odpowiadasz za pomocą Y polecenia lub A, zostanie wyświetlony pasek postępu.
  • Continue: (Ustawienie domyślne) Wyświetla pasek postępu i kontynuuje wykonywanie.
  • SilentlyContinue: wykonuje polecenie, ale nie wyświetla paska postępu.
Type: ActionPreference
Aliases: proga
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

-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 verbose 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ść $VerbosePreference zmiennej dla bieżącego polecenia. Ponieważ domyślna wartość zmiennej $VerbosePreference to SilentlyContinue, verbose komunikaty nie są domyślnie wyświetlane.

  • -Verbose:$true ma taki sam efekt jak -Verbose
  • -Verbose:$false pomija wyświetlanie komunikatów verbose . Użyj tego parametru, gdy wartość parametru $VerbosePreference nie ma wartości SilentlyContinue (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ść $WarningPreference zmiennej 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 .

  • Break wprowadza debuger po wystąpieniu ostrzeżenia.
  • Continue Wyświetla komunikaty ostrzegawcze i kontynuuje wykonywanie polecenia. Wartość domyślna to Continue.
  • Inquire Wyświetla komunikat ostrzegawczy i monituje o potwierdzenie przed kontynuowaniem wykonywania. Ta wartość jest rzadko używana.
  • SilentlyContinue pomija komunikat ostrzegawczy i kontynuuje wykonywanie polecenia.
  • Stop Wyświetla komunikat ostrzegawczy i zatrzymuje wykonywanie polecenia.

Uwaga

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

-WarningVariable

Przechowuje rekordy ostrzegawcze 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 tablicowej, takiej jak $a[0] lub $warning[1,2] , aby odwoływać się do określonych ostrzeżeń przechowywanych w zmiennej.

Uwaga

Zmienna ostrzegawcza zawiera wszystkie ostrzeżenia wygenerowane 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ść $WhatIfPreference zmiennej 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.

  • $true ma taki sam efekt jak -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 poleceniu Remove-Item :

Remove-Item Date.csv -WhatIf

Zamiast usuwać element, program PowerShell wyświetla listę operacji, których dotyczy, oraz 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ść $ConfirmPreference zmiennej dla bieżącego polecenia. Wartość domyślna to true. Aby uzyskać więcej informacji, zobacz about_Preference_Variables.

  • $true ma taki sam efekt jak -Confirm.
  • $false Pomija automatyczne potwierdzenie, które występuje, gdy wartość $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, i prosi 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:

Response Result
Yes (Y) Wykonaj wybraną akcję.
Yes to All (A) Wykonaj wszystkie akcje i pomiń kolejne Confirm
wykonuje zapytania dotyczące tego polecenia.
No (N): Nie wykonuj akcji.
No to All (L): Nie wykonuj żadnych akcji i pomijaj kolejne
Confirm wykonuje zapytania dotyczące 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ę zagnieżdżonych, w której można pracować, dopóki nie będzie można wybrać Confirm opcji. Wiersz polecenia dla sesji zagnieżdżonej ma dwa dodatkowe daszki (>>), aby wskazać, że jest to operacja podrzędna oryginalnego polecenia nadrzędnego. Polecenia i skrypty można uruchamiać w zagnieżdżonej sesji. Aby zakończyć sesję zagnieżdżoną i wró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

Zobacz też