about_Preference_Variables

  • Artykuł

Krótki opis

Zmienne, które dostosują zachowanie programu PowerShell.

Długi opis

Program PowerShell zawiera zestaw zmiennych, które umożliwiają dostosowanie jego zachowania. Te zmienne preferencji działają jak opcje w systemach opartych na graficznym interfejsie użytkownika.

Zmienne preferencji wpływają na środowisko operacyjne programu PowerShell i wszystkie polecenia uruchamiane w środowisku. W wielu przypadkach polecenia cmdlet mają parametry, których można użyć do zastąpienia zachowania preferencji dla określonego polecenia.

W poniższej tabeli wymieniono zmienne preferencji i ich wartości domyślne.

Zmienna Wartość domyślna
$ConfirmPreference High
$DebugPreference SilentlyContinue
$ErrorActionPreference Continue
$ErrorView NormalView
$FormatEnumerationLimit 4
$InformationPreference SilentlyContinue
$LogCommandHealthEvent $False (nie zarejestrowano)
$LogCommandLifecycleEvent $False (nie zarejestrowano)
$LogEngineHealthEvent $True (zarejestrowane)
$LogEngineLifecycleEvent $True (zarejestrowane)
$LogProviderLifecycleEvent $True (zarejestrowane)
$LogProviderHealthEvent $True (zarejestrowane)
$MaximumAliasCount 4096
$MaximumDriveCount 4096
$MaximumErrorCount 256
$MaximumFunctionCount 4096
$MaximumHistoryCount 4096
$MaximumVariableCount 4096
$OFS Znak spacji (" ")
$OutputEncoding ASCIIEncoding Obiektu
$ProgressPreference Continue
$PSDefaultParameterValues @{} (pusta tabela skrótów)
$PSEmailServer $Null (brak)
$PSModuleAutoLoadingPreference All
$PSSessionApplicationName 'wsman'
$PSSessionConfigurationName 'http://schemas.microsoft.com/powershell/Microsoft.PowerShell'
$PSSessionOption PSSessionOption Obiektu
$Transcript $Null (brak)
$VerbosePreference SilentlyContinue
$WarningPreference Continue
$WhatIfPreference $False

Program PowerShell zawiera następujące zmienne środowiskowe, które przechowują preferencje użytkownika. Aby uzyskać więcej informacji na temat tych zmiennych środowiskowych, zobacz about_Environment_Variables.

  • env:PSExecutionPolicyPreference
  • $env:PSModulePath

Uwaga

Zmiany zmiennej preferencji zaczynają obowiązywać tylko w skryptach i funkcjach, jeśli te skrypty lub funkcje są zdefiniowane w tym samym zakresie co zakres, w którym były używane preferencje. Aby uzyskać więcej informacji, zobacz about_Scopes.

Praca ze zmiennymi preferencji

W tym dokumencie opisano każdą ze zmiennych preferencji.

Aby wyświetlić bieżącą wartość określonej zmiennej preferencji, wpisz nazwę zmiennej. Na przykład następujące polecenie wyświetla wartość zmiennej $ConfirmPreference .

 $ConfirmPreference

High

Aby zmienić wartość zmiennej, użyj instrukcji przypisania. Na przykład poniższa instrukcja zmienia wartość parametru $ConfirmPreference na Średni.

$ConfirmPreference = "Medium"

Ustawione wartości są specyficzne dla bieżącej sesji programu PowerShell. Aby zmienne były skuteczne we wszystkich sesjach programu PowerShell, dodaj je do profilu programu PowerShell. Aby uzyskać więcej informacji, zobacz about_Profiles.

Zdalna praca

Po uruchomieniu poleceń na komputerze zdalnym polecenia zdalne podlegają tylko preferencjom ustawionym w kliencie programu PowerShell komputera zdalnego. Na przykład po uruchomieniu polecenia zdalnego wartość zmiennej komputera $DebugPreference zdalnego określa sposób, w jaki program PowerShell reaguje na komunikaty debugowania.

Aby uzyskać więcej informacji na temat poleceń zdalnych, zobacz about_Remote.

$ConfirmPreference

Określa, czy program PowerShell automatycznie monituje o potwierdzenie przed uruchomieniem polecenia cmdlet lub funkcji.

Zmienna $ConfirmPreference przyjmuje jedną z ConfirmImpact wartości wyliczenia: Wysoka, Średnia, Niska lub Brak.

Polecenia cmdlet i funkcje są przypisywane do ryzyka wysokiego, średniego lub niskiego. Jeśli wartość zmiennej $ConfirmPreference jest mniejsza lub równa ryzyku przypisanemu do polecenia cmdlet lub funkcji, program PowerShell automatycznie wyświetli monit o potwierdzenie przed uruchomieniem polecenia cmdlet lub funkcji.

Jeśli wartość zmiennej $ConfirmPreference to None, program PowerShell nigdy nie wyświetli monitu przed uruchomieniem polecenia cmdlet lub funkcji.

Aby zmienić zachowanie potwierdzające dla wszystkich poleceń cmdlet i funkcji w sesji, zmień $ConfirmPreference wartość zmiennej.

Aby zastąpić dla $ConfirmPreference pojedynczego polecenia, użyj parametru Confirm polecenia cmdlet lub funkcji. Aby zażądać potwierdzenia, użyj polecenia -Confirm. Aby pominąć potwierdzenie, użyj polecenia -Confirm:$false.

Prawidłowe wartości elementu $ConfirmPreference:

  • Brak: program PowerShell nie wyświetla automatycznie monitu. Aby zażądać potwierdzenia określonego polecenia, użyj parametru Confirm polecenia cmdlet lub funkcji.
  • Niski: program PowerShell monituje o potwierdzenie przed uruchomieniem poleceń cmdlet lub funkcji z niskim, średnim lub wysokim ryzykiem.
  • Średni: program PowerShell monituje o potwierdzenie przed uruchomieniem poleceń cmdlet lub funkcji ze średnim lub wysokim ryzykiem.
  • Wysoki: program PowerShell monituje o potwierdzenie przed uruchomieniem poleceń cmdlet lub funkcji z wysokim ryzykiem.

Szczegółowe wyjaśnienie

Program PowerShell może automatycznie monitować o potwierdzenie przed wykonaniem akcji. Na przykład gdy polecenie cmdlet lub funkcja znacząco wpływa na system w celu usunięcia danych lub użycia znacznej ilości zasobów systemowych.

Remove-Item -Path C:\file.txt

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

Oszacowanie ryzyka jest atrybutem polecenia cmdlet lub funkcji znanej jako ConfirmImpact. Użytkownicy nie mogą go zmienić.

Polecenia cmdlet i funkcje, które mogą stanowić zagrożenie dla systemu, mają parametr Confirm , którego można użyć do żądania lub pomijania potwierdzenia dla pojedynczego polecenia.

Ponieważ większość poleceń cmdlet i funkcji używa domyślnej wartości ryzyka, ConfirmImpact, średniej i domyślnej $ConfirmPreference wartości jest Wysoka, automatyczne potwierdzanie rzadko występuje. Można jednak aktywować automatyczne potwierdzenie, zmieniając wartość na $ConfirmPreferenceŚrednia lub Niska.

Przykłady

W tym przykładzie pokazano efekt wartości domyślnej $ConfirmPreference zmiennej High. Wartość Wysoka potwierdza tylko polecenia cmdlet i funkcje wysokiego ryzyka. Ponieważ większość poleceń cmdlet i funkcji jest średnim ryzykiem, nie jest automatycznie potwierdzana i Remove-Item usuwa plik. Dodanie -Confirm do polecenia powoduje wyświetlenie monitu użytkownika o potwierdzenie.

$ConfirmPreference

High

Remove-Item -Path C:\temp1.txt

Użyj polecenia -Confirm , aby zażądać potwierdzenia.

Remove-Item -Path C:\temp2.txt -Confirm

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

W poniższym przykładzie pokazano efekt zmiany wartości na $ConfirmPreferenceŚredni. Ponieważ większość poleceń cmdlet i funkcji jest średnim ryzykiem, są one automatycznie potwierdzane. Aby pominąć monit o potwierdzenie dla pojedynczego polecenia, użyj parametru Confirm z wartością $false.

$ConfirmPreference = "Medium"
Remove-Item -Path C:\temp2.txt

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

Remove-Item -Path C:\temp3.txt -Confirm:$false

$DebugPreference

Określa sposób, w jaki program PowerShell reaguje na debugowanie komunikatów generowanych przez skrypt, polecenie cmdlet lub dostawcę Write-Debug albo za pomocą polecenia w wierszu polecenia.

Zmienna $DebugPreference przyjmuje jedną z ActionPreference wartości wyliczenia: SilentlyContinue, Stop, Continue, Inquire, Ignore, Suspend lub Break.

Niektóre polecenia cmdlet wyświetlają komunikaty debugowania, które są zazwyczaj komunikatami technicznymi przeznaczonymi dla programistów i specjalistów pomocy technicznej. Domyślnie komunikaty debugowania nie są wyświetlane, ale można wyświetlać komunikaty debugowania, zmieniając wartość $DebugPreference.

Aby wyświetlić lub ukryć komunikaty debugowania dla określonego polecenia, możesz użyć wspólnego parametru debugowania polecenia cmdlet. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

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

  • Zatrzymaj: wyświetla komunikat debugowania i zatrzymuje wykonywanie. Zapisuje błąd w konsoli programu .
  • Zapytanie: wyświetla komunikat debugowania i pyta, czy chcesz kontynuować.
  • Kontynuuj: wyświetla komunikat debugowania i kontynuuje wykonywanie.
  • SilentlyContinue: (Ustawienie domyślne) Brak efektu. Komunikat debugowania nie jest wyświetlany i wykonywanie jest kontynuowane bez przerwy.

Dodanie wspólnego parametru debugowania do polecenia, gdy polecenie jest skonfigurowane do generowania komunikatu debugowania, zmienia wartość zmiennej $DebugPreference na Inquire.

Przykłady

W poniższych przykładach pokazano efekt zmiany wartości $DebugPreference po Write-Debug wprowadzeniu polecenia w wierszu polecenia. Zmiana dotyczy wszystkich komunikatów debugowania, w tym komunikatów generowanych przez polecenia cmdlet i skrypty. W przykładach pokazano parametr Debug , który wyświetla lub ukrywa komunikaty debugowania związane z pojedynczym poleceniem.

W tym przykładzie pokazano efekt $DebugPreference wartości domyślnej zmiennej SilentlyContinue. Domyślnie Write-Debug komunikat debugowania polecenia cmdlet nie jest wyświetlany i trwa przetwarzanie. Gdy parametr debugowania jest używany, zastępuje preferencję dla pojedynczego polecenia. Użytkownik jest monitowany o potwierdzenie.

$DebugPreference

SilentlyContinue

Write-Debug -Message "Hello, World"

Write-Debug -Message "Hello, World" -Debug

DEBUG: Hello, World
Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend
[?] Help (default is "Y"):

W tym przykładzie pokazano efekt $DebugPreference z wartością Kontynuuj . Zostanie wyświetlony komunikat debugowania, a polecenie będzie nadal przetwarzane.

$DebugPreference = "Continue"
Write-Debug -Message "Hello, World"

DEBUG: Hello, World

W tym przykładzie użyto parametru Debug z wartością $false , aby pominąć komunikat dla pojedynczego polecenia. Komunikat debugowania nie jest wyświetlany.

Write-Debug -Message "Hello, World" -Debug:$false

W tym przykładzie pokazano efekt $DebugPreference ustawiania wartości Stop . Zostanie wyświetlony komunikat debugowania i polecenie zostanie zatrzymane.

$DebugPreference = "Stop"
Write-Debug -Message "Hello, World"

DEBUG: Hello, World
Write-Debug : The running command stopped because the preference variable
 "DebugPreference" or common parameter is set to Stop: Hello, World
At line:1 char:1
+ Write-Debug -Message "Hello, World"

W tym przykładzie użyto parametru Debug z wartością $false , aby pominąć komunikat dla pojedynczego polecenia. Komunikat debugowania nie jest wyświetlany i przetwarzanie nie jest zatrzymane.

Write-Debug -Message "Hello, World" -Debug:$false

W tym przykładzie pokazano efekt $DebugPreference ustawiania wartości Inquire . Zostanie wyświetlony komunikat debugowania i zostanie wyświetlony monit o potwierdzenie.

$DebugPreference = "Inquire"
Write-Debug -Message "Hello, World"

DEBUG: Hello, World

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend
[?] Help (default is "Y"):

W tym przykładzie użyto parametru Debug z wartością $false , aby pominąć komunikat dla pojedynczego polecenia. Komunikat debugowania nie jest wyświetlany i trwa przetwarzanie.

Write-Debug -Message "Hello, World" -Debug:$false

$ErrorActionPreference

Określa, jak program PowerShell reaguje na błąd, który nie kończy przetwarzania polecenia cmdlet. Na przykład w wierszu polecenia lub w skrycie, poleceniu cmdlet lub dostawcy, takich jak błędy wygenerowane przez Write-Error polecenie cmdlet.

Zmienna $ErrorActionPreference przyjmuje jedną z wartości ActionPreference wartości wyliczenia: SilentlyContinue, Stop, Continue, Inquire, Ignore lub Suspend.

Typowego parametru ErrorAction polecenia cmdlet można użyć do zastąpienia preferencji dla określonego polecenia.

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

  • Kontynuuj: (ustawienie domyślne) Wyświetla komunikat o błędzie i kontynuuje wykonywanie.
  • Ignoruj: pomija komunikat o błędzie i kontynuuje wykonywanie polecenia. Wartość Ignoruj jest przeznaczona do użycia poszczególnych poleceń, a nie do użycia jako zapisanych preferencji. Ignoruj nie jest prawidłową wartością zmiennej $ErrorActionPreference .
  • Zapytanie: wyświetla komunikat o błędzie i pyta, czy chcesz kontynuować.
  • SilentlyContinue: Brak efektu. Komunikat o błędzie nie jest wyświetlany i wykonywanie jest kontynuowane bez przerwy.
  • Zatrzymaj: wyświetla komunikat o błędzie i zatrzymuje wykonywanie. Oprócz wygenerowanego błędu wartość Stop generuje obiekt ActionPreferenceStopException do strumienia błędów.
  • Wstrzymywanie: Automatycznie zawiesza zadanie przepływu pracy, aby umożliwić dalsze badanie. Po zbadaniu można wznowić przepływ pracy. Wartość Wstrzymanie jest przeznaczona do użycia poszczególnych poleceń, a nie do użycia jako zapisanych preferencji. Wstrzymanie nie jest prawidłową wartością dla zmiennej $ErrorActionPreference .

$ErrorActionPreferenceparametr ErrorAction nie ma wpływu na sposób, w jaki program PowerShell reaguje na błędy zakończenia, które zatrzymują przetwarzanie poleceń cmdlet. Aby uzyskać więcej informacji na temat wspólnego parametru ErrorAction , zobacz about_CommonParameters.

Przykłady

W tych przykładach pokazano efekt różnych wartości zmiennej $ErrorActionPreference . Parametr ErrorAction służy do zastępowania $ErrorActionPreference wartości.

W tym przykładzie jest wyświetlana wartość domyślna $ErrorActionPreference Kontynuuj. Zostanie wygenerowany błąd, który nie kończy się. Zostanie wyświetlony komunikat, a przetwarzanie będzie kontynuowane.

# Change the ErrorActionPreference to 'Continue'
$ErrorActionPreference = 'Continue'
# Generate a non-terminating error and continue processing the script.
Write-Error -Message  'Test Error' ; Write-Host 'Hello World'

Write-Error -Message  'Test Error' ; Write-Host 'Hello World' : Test Error
    + CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
    + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

Hello World

W tym przykładzie przedstawiono wartość domyślną $ErrorActionPreference , Inquire. Zostanie wygenerowany błąd i zostanie wyświetlony monit o akcję.

# Change the ErrorActionPreference to 'Inquire'
$ErrorActionPreference = 'Inquire'
Write-Error -Message 'Test Error' ; Write-Host 'Hello World'

Confirm
Test Error
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend  [?] Help (default is "Y"):

W tym przykładzie pokazano $ErrorActionPreference zestaw na wartość SilentlyContinue. Komunikat o błędzie jest pomijany.

# Change the ErrorActionPreference to 'SilentlyContinue'
$ErrorActionPreference = 'SilentlyContinue'
# Generate an error message
Write-Error -Message 'Test Error' ; Write-Host 'Hello World'
# Error message is suppressed and script continues processing

Hello World

W tym przykładzie pokazano $ErrorActionPreference ustawienie Zatrzymaj. Pokazuje on również dodatkowy obiekt wygenerowany dla zmiennej $Error .

# Change the ErrorActionPreference to 'Stop'
$ErrorActionPreference = 'Stop'
# Error message is generated and script stops processing
Write-Error -Message 'Test Error' ; Write-Host 'Hello World'

# Show the ActionPreferenceStopException and the error generated
$Error[0]
$Error[1]

Write-Error -Message 'Test Error' ; Write-Host 'Hello World' : Test Error
At line:1 char:1
+ Write-Error -Message 'Test Error' ; Write-Host 'Hello World'
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
    + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

The running command stopped because the preference variable "ErrorActionPreference"
or common parameter is set to Stop: Test Error

Write-Error -Message 'Test Error' ; Write-Host 'Hello World' : Test Error
At line:1 char:1
+ Write-Error -Message 'Test Error' ; Write-Host 'Hello World'
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
    + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

$ErrorView

Określa format wyświetlania komunikatów o błędach w programie PowerShell.

Zmienna $ErrorView przyjmuje jedną z ErrorView wartości wyliczenia: NormalView lub CategoryView.

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

  • NormalView: szczegółowy widok przeznaczony dla większości użytkowników. Składa się z opisu błędu i nazwy obiektu zaangażowanego w błąd.

  • CategoryView: zwięzły, ustrukturyzowany widok przeznaczony dla środowisk produkcyjnych. Format jest następujący:

    {Category}: ({TargetName}:{TargetType}):[{Activity}], {Reason}

Aby uzyskać więcej informacji na temat pól w klasie CategoryView, zobacz ErrorCategoryInfo , klasa.

Przykłady

W tym przykładzie pokazano, jak pojawia się błąd, gdy wartość jest wartością $ErrorView domyślną NormalView. Get-ChildItem służy do znajdowania pliku nieistniejącego.

Get-ChildItem -Path C:\nofile.txt

Get-ChildItem : Cannot find path 'C:\nofile.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -Path C:\nofile.txt

W tym przykładzie pokazano, jak ten sam błąd pojawia się, gdy wartość elementu zostanie zmieniona $ErrorView na CategoryView.

$ErrorView = "CategoryView"
Get-ChildItem -Path C:\nofile.txt

ObjectNotFound: (C:\nofile.txt:String) [Get-ChildItem], ItemNotFoundException

W tym przykładzie pokazano, że wartość ma $ErrorView wpływ tylko na wyświetlanie błędu. Nie zmienia struktury obiektu błędu przechowywanego w zmiennej automatycznej $Error . Aby uzyskać informacje o zmiennej automatycznej $Error , zobacz about_automatic_variables.

Następujące polecenie pobiera obiekt ErrorRecord skojarzony z najnowszym błędem w tablicy błędów, element 0 i formatuje właściwości obiektu na liście.

$Error[0] | Format-List -Property * -Force

PSMessageDetails      :
Exception             : System.Management.Automation.ItemNotFoundException:
                          Cannot find path 'C:\nofile.txt' because it does
                          not exist.
                        at System.Management.Automation.SessionStateInternal.
                          GetChildItems(String path, Boolean recurse, UInt32
                          depth, CmdletProviderContext context)
                        at System.Management.Automation.ChildItemCmdlet
                          ProviderIntrinsics.Get(String path, Boolean
                          recurse, UInt32 depth, CmdletProviderContext context)
                        at Microsoft.PowerShell.Commands.GetChildItemCommand.
                          ProcessRecord()
TargetObject          : C:\nofile.txt
CategoryInfo          : ObjectNotFound: (C:\nofile.txt:String) [Get-ChildItem],
                          ItemNotFoundException
FullyQualifiedErrorId : PathNotFound,
                          Microsoft.PowerShell.Commands.GetChildItemCommand
ErrorDetails          :
InvocationInfo        : System.Management.Automation.InvocationInfo
ScriptStackTrace      : at <ScriptBlock>, <No file>: line 1
PipelineIterationInfo : {0, 1}

$FormatEnumerationLimit

Określa liczbę wyliczonych elementów uwzględnionych w wyświetlaczu. Ta zmienna nie ma wpływu na obiekty bazowe, tylko wyświetlanie. Jeśli wartość $FormatEnumerationLimit elementu jest mniejsza niż liczba wyliczonych elementów, program PowerShell dodaje wielokropek (...), aby wskazać, że elementy nie są wyświetlane.

Prawidłowe wartości: Liczby całkowite (Int32)

Wartość domyślna: 4

Przykłady

W tym przykładzie pokazano, jak za pomocą zmiennej $FormatEnumerationLimit poprawić wyświetlanie wyliczonych elementów.

Polecenie w tym przykładzie generuje tabelę zawierającą listę wszystkich usług uruchomionych na komputerze w dwóch grupach: jeden dla uruchamiania usług i jeden dla zatrzymanych usług. Używa Get-Service polecenia , aby pobrać wszystkie usługi, a następnie wysyła wyniki za pośrednictwem potoku do Group-Object polecenia cmdlet, które grupuje wyniki według stanu usługi.

Wynikiem jest tabela zawierająca stan w kolumnie Nazwa oraz procesy w kolumnie Grupa . Aby zmienić etykiety kolumn, użyj tabeli skrótów, zobacz about_Hash_Tables. Aby uzyskać więcej informacji, zobacz przykłady w temacie Format-Table.

Znajdź bieżącą wartość .$FormatEnumerationLimit

$FormatEnumerationLimit

4

Wyświetl listę wszystkich usług pogrupowanych według stanu. W kolumnie Grupa dla każdego stanu znajduje się maksymalnie cztery usługi, ponieważ $FormatEnumerationLimit ma wartość 4.

Get-Service | Group-Object -Property Status

Count  Name       Group
-----  ----       -----
60     Running    {AdtAgent, ALG, Ati HotKey Poller, AudioSrv...}
41     Stopped    {Alerter, AppMgmt, aspnet_state, ATI Smart...}

Aby zwiększyć liczbę elementów wymienionych, zwiększ wartość $FormatEnumerationLimit do 1000. Użyj funkcji Get-Service i Group-Object , aby wyświetlić usługi.

$FormatEnumerationLimit = 1000
Get-Service | Group-Object -Property Status

Count  Name       Group
-----  ----       -----
60     Running    {AdtAgent, ALG, Ati HotKey Poller, AudioSrv, BITS, CcmExec...
41     Stopped    {Alerter, AppMgmt, aspnet_state, ATI Smart, Browser, CiSvc...

Użyj parametru Format-Table Wrap, aby wyświetlić listę usług.

Get-Service | Group-Object -Property Status | Format-Table -Wrap

Count  Name       Group
-----  ----       -----
60     Running    {AdtAgent, ALG, Ati HotKey Poller, AudioSrv, BITS, CcmExec,
                  Client for NFS, CryptSvc, DcomLaunch, Dhcp, dmserver,
                  Dnscache, ERSvc, Eventlog, EventSystem, FwcAgent, helpsvc,
                  HidServ, IISADMIN, InoRPC, InoRT, InoTask, lanmanserver,
                  lanmanworkstation, LmHosts, MDM, Netlogon, Netman, Nla,
                  NtLmSsp, PlugPlay, PolicyAgent, ProtectedStorage, RasMan,
                  RemoteRegistry, RpcSs, SamSs, Schedule, seclogon, SENS,
                  SharedAccess, ShellHWDetection, SMT PSVC, Spooler,
                  srservice, SSDPSRV, stisvc, TapiSrv, TermService, Themes,
                  TrkWks, UMWdf, W32Time, W3SVC, WebClient, winmgmt, wscsvc,
                  wuauserv, WZCSVC, zzInterix}

41     Stopped    {Alerter, AppMgmt, aspnet_state, ATI Smart, Browser, CiSvc,
                  ClipSrv, clr_optimization_v2.0.50727_32, COMSysApp,
                  CronService, dmadmin, FastUserSwitchingCompatibility,
                  HTTPFilter, ImapiService, Mapsvc, Messenger, mnmsrvc,
                  MSDTC, MSIServer, msvsmon80, NetDDE, NetDDEdsdm, NtmsSvc,
                  NVSvc, ose, RasAuto, RDSessMgr, RemoteAccess, RpcLocator,
                  SCardSvr, SwPrv, SysmonLog, TlntSvr, upnphost, UPS, VSS,
                  WmdmPmSN, Wmi, WmiApSrv, xmlprov}

$InformationPreference

Zmienna $InformationPreference umożliwia ustawianie preferencji strumienia informacji, które mają być wyświetlane użytkownikom. W szczególności komunikaty informacyjne dodane do poleceń lub skryptów przez dodanie polecenia cmdlet Write-Information . Jeśli jest używany parametr InformationAction, jego wartość zastępuje wartość zmiennej$InformationPreference. Write-Information wprowadzono w programie PowerShell 5.0.

Zmienna $InformationPreference przyjmuje jedną z wartości ActionPreference wartości wyliczenia: SilentlyContinue, Stop, Continue, Inquire, Ignore lub Suspend.

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

  • Zatrzymaj: zatrzymuje polecenie lub skrypt w wystąpieniu Write-Information polecenia.
  • Zapytanie: wyświetla komunikat informacyjny określony w Write-Information poleceniu, a następnie pyta, czy chcesz kontynuować.
  • Kontynuuj: wyświetla komunikat informacyjny i kontynuuje działanie.
  • Wstrzymywanie: automatycznie zawiesza zadanie przepływu pracy po wykonaniu Write-Information polecenia, aby umożliwić użytkownikom wyświetlanie komunikatów przed kontynuowaniem. Przepływ pracy można wznowić według uznania użytkownika.
  • SilentlyContinue: (Ustawienie domyślne) Brak efektu. Komunikaty informacyjne nie są wyświetlane, a skrypt będzie kontynuowany bez przerwy.

$Log*Zdarzenie

Zmienne preferencji Dziennika*Zdarzenia określają, które typy zdarzeń są zapisywane w dzienniku zdarzeń programu PowerShell w Podgląd zdarzeń. Domyślnie rejestrowane są tylko zdarzenia aparatu i dostawcy. Można jednak użyć zmiennych preferencji Dziennik*Zdarzenie , aby dostosować dziennik, na przykład rejestrowanie zdarzeń dotyczących poleceń.

Zmienne preferencji Dziennika*Zdarzenia są następujące:

  • $LogCommandHealthEvent: rejestruje błędy i wyjątki w inicjowaniu i przetwarzaniu poleceń. Wartość domyślna to $false (nie jest rejestrowana).
  • $LogCommandLifecycleEvent: rejestruje uruchamianie i zatrzymywanie poleceń oraz potoków poleceń i wyjątków zabezpieczeń w odnajdywanie poleceń. Wartość domyślna to $false (nie jest rejestrowana).
  • $LogEngineHealthEvent: Rejestruje błędy i błędy sesji. Wartość domyślna to $true (rejestrowana).
  • $LogEngineLifecycleEvent: rejestruje otwieranie i zamykanie sesji. Wartość domyślna to $true (rejestrowana).
  • $LogProviderHealthEvent: Rejestruje błędy dostawcy, takie jak błędy odczytu i zapisu, błędy wyszukiwania i błędy wywołania. Wartość domyślna to $true (rejestrowana).
  • $LogProviderLifecycleEvent: rejestruje dodawanie i usuwanie dostawców programu PowerShell. Wartość domyślna to $true (rejestrowana). Aby uzyskać informacje o dostawcach programu PowerShell, zobacz about_Providers.

Aby włączyć zdarzenie Log*, wpisz zmienną z wartością $true, na przykład:

$LogCommandLifeCycleEvent = $true

Aby wyłączyć typ zdarzenia, wpisz zmienną z wartością $false, na przykład:

$LogCommandLifeCycleEvent = $false

Zdarzenia, które włączysz, są skuteczne tylko dla bieżącej konsoli programu PowerShell. Aby zastosować konfigurację do wszystkich konsol, zapisz ustawienia zmiennych w profilu programu PowerShell. Aby uzyskać więcej informacji, zobacz about_Profiles.

$MaximumAliasCount

Określa, ile aliasów jest dozwolonych w sesji programu PowerShell. Wartość domyślna to 4096 i powinna być wystarczająca dla większości zastosowań. Możesz dostosować $MaximumAliasCount się do swoich potrzeb.

Prawidłowe wartości: 1024 – 32768 (Int32)

Ustawienie domyślne: 4096

Aby zliczyć aliasy w systemie, wpisz:

(Get-Alias).count

$MaximumDriveCount

Określa, ile dysków programu PowerShell jest dozwolonych w danej sesji. Na przykład dyski systemu plików i magazyny danych, które są udostępniane przez dostawców programu PowerShell i są wyświetlane jako dyski, takie jak Alias: dyski i HKLM: .

Prawidłowe wartości: 1024 – 32768 (Int32)

Ustawienie domyślne: 4096

Aby zliczyć aliasy w systemie, wpisz:

(Get-PSDrive).count

$MaximumErrorCount

Określa, ile błędów jest zapisywanych w historii błędów dla sesji.

Prawidłowe wartości: 256 – 32768 (Int32)

Ustawienie domyślne: 256

Obiekty reprezentujące każdy zachowany błąd są przechowywane w zmiennej automatycznej $Error . $Error zawiera tablicę obiektów rekordów błędów. Najnowszy błąd to pierwszy obiekt w tablicy . $Error[0]

Aby zliczyć błędy w systemie, użyj $Error właściwości Count tablicy.

$Error.count

Aby wyświetlić określony błąd, użyj [0] notacji tablicy, aby wyświetlić najnowszy błąd.

$Error[0]

Aby wyświetlić najstarszy zachowany błąd, wpisz:

$Error[($Error.Count -1]

Parametr Force zastępuje specjalne formatowanie obiektów ErrorRecord i przywraca konwencjonalny format. Aby wyświetlić właściwości obiektu ErrorRecord , wpisz następujące polecenie:

$Error[0] | Format-List -Property * -Force

W tym przykładzie $Error.Count zostanie wyświetlona liczba błędów. Aby usunąć wszystkie błędy z historii błędów, użyj Clear metody tablicy błędów.

$Error.Count

17

$Error.Clear()
$Error.Count

0

Aby znaleźć wszystkie właściwości i metody tablicy błędów, użyj Get-Member polecenia cmdlet z parametrem InputObject . Gdy używasz parametru InputObject , Get-Member wyświetla właściwości i metody kolekcji.

Get-Member -InputObject $Error

W przypadku potoku kolekcji obiektów do Get-Memberobiektu Get-Member program wyświetla właściwości i metody obiektów w kolekcji.

$Error | Get-Member

$MaximumFunctionCount

Określa, ile funkcji jest dozwolonych w danej sesji.

Prawidłowe wartości: 1024 – 32768 (Int32)

Ustawienie domyślne: 4096

Aby wyświetlić funkcje w sesji, użyj dysku programu PowerShell Function: uwidocznionego przez dostawcę programu PowerShell Function . Aby uzyskać więcej informacji na temat dostawcy Function , about_Function_Provider.

Aby wyświetlić listę funkcji w bieżącej sesji, wpisz:

Get-ChildItem Function:

Aby zliczyć funkcje w bieżącej sesji, wpisz:

(Get-ChildItem Function:).Count

$MaximumHistoryCount

Określa liczbę poleceń zapisanych w historii poleceń dla bieżącej sesji.

Prawidłowe wartości: 1 – 32768 (Int32)

Ustawienie domyślne: 4096

Aby określić liczbę poleceń bieżących zapisanych w historii poleceń, wpisz:

(Get-History).Count

Aby wyświetlić polecenia zapisane w historii sesji, użyj Get-History polecenia cmdlet . Aby uzyskać więcej informacji, zobacz about_History.

$MaximumVariableCount

Określa, ile zmiennych jest dozwolonych w danej sesji, w tym zmiennych automatycznych, zmiennych preferencji i zmiennych tworzonych w poleceniach i skryptach.

Prawidłowe wartości: 1024 – 32768 (Int32)

Ustawienie domyślne: 4096

Aby wyświetlić zmienne w sesji, użyj Get-Variable polecenia cmdlet i funkcji dysku programu PowerShell Variable: i dostawcy programu PowerShell Variable . Aby uzyskać informacje, zobacz about_Variable_Provider.

Aby znaleźć bieżącą liczbę zmiennych w systemie, wpisz:

(Get-Variable).Count

$OFS

Separator pola wyjściowego (OFS) określa znak, który oddziela elementy tablicy przekonwertowanej na ciąg.

Prawidłowe wartości: dowolny ciąg.

Ustawienie domyślne: spacja

Domyślnie zmienna $OFS nie istnieje, a separator pliku wyjściowego jest spacją, ale możesz dodać tę zmienną i ustawić ją na dowolny ciąg. Możesz zmienić wartość $OFS w sesji, wpisując $OFS="<value>".

Uwaga

Jeśli spodziewasz się domyślnej wartości miejsca (" ") w danych wyjściowych skryptu, modułu lub konfiguracji, uważaj, aby $OFS wartość domyślna nie została zmieniona w innym miejscu w kodzie.

Przykłady

W tym przykładzie pokazano, że miejsce jest używane do oddzielania wartości, gdy tablica jest konwertowana na ciąg. W takim przypadku tablica liczb całkowitych jest przechowywana w zmiennej, a następnie zmienna jest rzutowana jako ciąg.

$array = 1,2,3,4
[string]$array

1 2 3 4

Aby zmienić separator, dodaj zmienną $OFS , przypisując do niej wartość. Zmienna musi mieć nazwę $OFS.

$OFS = "+"
[string]$array

1+2+3+4

Aby przywrócić domyślne zachowanie, możesz przypisać spację (" ") do wartości $OFS lub usunąć zmienną. Następujące polecenia usuwają zmienną, a następnie sprawdzają, czy separator jest spacją.

Remove-Variable OFS
[string]$array

1 2 3 4

$OutputEncoding

Określa metodę kodowania znaków używaną przez program PowerShell podczas potokowania danych do aplikacji natywnych.

Uwaga

W większości scenariuszy wartość parametru $OutputEncoding powinna być zgodna z wartością [Console]::InputEncoding.

Prawidłowe wartości są następujące: Obiekty pochodzące z klasy Kodowanie, takie jak ASCIIEncoding, UTF7Encoding, UTF8Encoding, UTF32Encoding i UnicodeEncoding.

Ustawienie domyślne: obiekt ASCIIEncoding .

Przykłady

Pierwsze polecenie znajduje wartość .$OutputEncoding Ponieważ wartość jest obiektem kodowania, wyświetl tylko jego właściwość EncodingName .

$OutputEncoding.EncodingName

W pozostałych przykładach użyto następującego skryptu programu PowerShell zapisanego w hexdump.ps1 celu zilustrowania zachowania programu $OutputEncoding.

$inputStream = [Console]::OpenStandardInput()
try {
    $buffer = [byte[]]::new(1024)
    $read = $inputStream.Read($buffer, 0, $buffer.Length)
    $actual = [byte[]]::new($read)
    [Array]::Copy($buffer, $actual, $read)
    Format-Hex -InputObject $actual
} finally {
    $inputStream.Dispose()
}

W poniższym przykładzie pokazano, jak wartość café ciągu jest kodowana do bajtów podczas potoku do hexdump.ps1 utworzonego powyżej. Pokazuje, że wartość ciągu jest kodowana przy użyciu schematu windows-1252 kodowania, który jest domyślnym kodowaniem w danym systemie.

'café' | powershell.exe -File .\hexdump.ps1

           00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

00000000   63 61 66 3F 0D 0A                                caf?..

W poniższym przykładzie pokazano, jak bajty zmieniają się podczas zmiany kodowania na UTF-8. Kodowanie é zamiast kodowania 0x3F w sposób wykonywany przez windows-1252 nie zostanie 0xC3 0xA9 teraz spowodowane użyciem kodowania UTF-8.

$OutputEncoding = [System.Text.UTF8Encoding]::new()
'café' | powershell.exe -File .\hexdump.ps1

           00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

00000000   63 61 66 C3 A9 0D 0A                             café..

$ProgressPreference

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.

Zmienna $ProgressPreference przyjmuje jedną z ActionPreference wartości wyliczenia: SilentlyContinue, Stop, Continue, Inquire, Ignore lub Suspend.

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

  • Zatrzymaj: 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.
  • Kontynuuj: (Ustawienie domyślne) Wyświetla pasek postępu i kontynuuje wykonywanie.
  • SilentlyContinue: wykonuje polecenie, ale nie wyświetla paska postępu.

$PSDefaultParameterValues

Określa wartości domyślne parametrów poleceń cmdlet i funkcji zaawansowanych. Wartość to tabela skrótu $PSDefaultParameterValues , w której klucz składa się z nazwy polecenia cmdlet i nazwy parametru oddzielonego dwukropkiem (:). Wartość jest niestandardową wartością domyślną, którą określisz.

$PSDefaultParameterValues wprowadzono w programie PowerShell 3.0.

Aby uzyskać więcej informacji na temat tej zmiennej preferencji, zobacz about_Parameters_Default_Values.

$PSEmailServer

Określa domyślny serwer poczty e-mail używany do wysyłania wiadomości e-mail. Ta zmienna preferencji jest używana przez polecenia cmdlet wysyłające wiadomości e-mail, takie jak polecenie cmdlet Send-MailMessage .

$PSModuleAutoloadingPreference

Włącza i wyłącza automatyczne importowanie modułów w sesji. Zmienna $PSModuleAutoloadingPreference nie istnieje domyślnie. Domyślne zachowanie, gdy zmienna nie jest zdefiniowana, jest taka sama jak $PSModuleAutoloadingPreference = 'All'.

Aby automatycznie zaimportować moduł, pobierz lub użyj polecenia zawartego w module.

Zmienna $PSModuleAutoloadingPreference przyjmuje jedną z PSModuleAutoLoadingPreference wartości wyliczenia:

  • All: Moduły są importowane automatycznie podczas pierwszego użycia.
  • ModuleQualified: Moduły są importowane automatycznie tylko wtedy, gdy użytkownik używa nazwy kwalifikowanej przez moduł polecenia w module. Jeśli na przykład użytkownik wpisze MyModule\MyCommand, program PowerShell zaimportuje moduł MyModule .
  • None: wyłącza automatyczne importowanie modułów. Aby zaimportować moduł, użyj Import-Module polecenia cmdlet .

Aby uzyskać więcej informacji na temat automatycznego importowania modułów, zobacz about_Modules.

$PSSessionApplicationName

Określa domyślną nazwę aplikacji dla zdalnego polecenia, które używa technologii Web Services for Management (WS-Management). Aby uzyskać więcej informacji, zobacz About Windows Remote Management (Informacje o zdalnym zarządzaniu systemem Windows).

Domyślna nazwa aplikacji systemu to WSMAN, ale możesz użyć tej zmiennej preferencji, aby zmienić wartość domyślną.

Nazwa aplikacji jest ostatnim węzłem w identyfikatorze URI połączenia. Na przykład nazwa aplikacji w następującym przykładowym identyfikatorze URI to WSMAN.

http://Server01:8080/WSMAN

Domyślna nazwa aplikacji jest używana, gdy zdalne polecenie nie określa identyfikatora URI połączenia ani nazwy aplikacji.

Usługa WinRM używa nazwy aplikacji, aby wybrać odbiornik do obsługi żądania połączenia. Wartość parametru powinna być zgodna z wartością właściwości URLPrefix odbiornika na komputerze zdalnym.

Aby zastąpić wartość domyślną systemu i wartość tej zmiennej, a następnie wybrać inną nazwę aplikacji dla określonej sesji, użyj parametrów Połączenie ionURI lub ApplicationName dla polecenia cmdlet New-PSSession, Enter-PSSession lub Invoke-Command.

Zmienna $PSSessionApplicationName preferencji jest ustawiana na komputerze lokalnym, ale określa odbiornik na komputerze zdalnym. Jeśli określona nazwa aplikacji nie istnieje na komputerze zdalnym, polecenie ustanowienia sesji zakończy się niepowodzeniem.

$PSSessionConfigurationName

Określa domyślną konfigurację sesji używaną do tworzenia nowych sesji w bieżącej sesji.

Ta zmienna preferencji jest ustawiana na komputerze lokalnym, ale określa konfigurację sesji, która znajduje się na komputerze zdalnym.

Wartość zmiennej $PSSessionConfigurationName jest w pełni kwalifikowanym identyfikatorem URI zasobu.

Wartość http://schemas.microsoft.com/PowerShell/microsoft.PowerShell domyślna wskazuje konfigurację sesji programu Microsoft.PowerShell na komputerze zdalnym.

Jeśli określisz tylko nazwę konfiguracji, następujący identyfikator URI schematu jest wstępnie utworzony:

http://schemas.microsoft.com/PowerShell/

Możesz zastąpić wartość domyślną i wybrać inną konfigurację sesji dla określonej sesji przy użyciu parametru New-PSSessionConfigurationName poleceń cmdlet , Enter-PSSessionlub Invoke-Command .

Wartość tej zmiennej można zmienić w dowolnym momencie. Pamiętaj, że wybrana konfiguracja sesji musi istnieć na komputerze zdalnym. Jeśli tak nie jest, polecenie utworzenia sesji korzystającej z konfiguracji sesji zakończy się niepowodzeniem.

Ta zmienna preferencji nie określa, które konfiguracje sesji lokalnej są używane, gdy użytkownicy zdalni tworzą sesję łączącą się z tym komputerem. Można jednak użyć uprawnień do konfiguracji sesji lokalnej, aby określić, którzy użytkownicy mogą z nich korzystać.

$PSSessionOption

Ustanawia wartości domyślne dla zaawansowanych opcji użytkownika w sesji zdalnej. Te preferencje opcji zastępują wartości domyślne systemu dla opcji sesji.

Zmienna $PSSessionOption zawiera obiekt PSSessionOption . Aby uzyskać więcej informacji, zobacz System.Management.Automation.Remoting.PSSessionOption. Każda właściwość obiektu reprezentuje opcję sesji. Na przykład właściwość NoCompression zamienia kompresję danych podczas sesji.

Domyślnie zmienna $PSSessionOption zawiera obiekt PSSessionOption z wartościami domyślnymi dla wszystkich opcji, jak pokazano poniżej.

MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : None
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
IncludePortInSPN                  : False
OutputBufferingMode               : None
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         : 209715200
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : -00:00:00.0010000

Aby uzyskać opisy tych opcji i więcej informacji, zobacz New-PSSessionOption. Aby uzyskać więcej informacji na temat poleceń zdalnych i sesji, zobacz about_Remote i about_PSSessions.

Aby zmienić wartość zmiennej $PSSessionOption preferencji, użyj New-PSSessionOption polecenia cmdlet , aby utworzyć obiekt PSSessionOption z preferowanymi wartościami opcji. Zapisz dane wyjściowe w zmiennej o nazwie $PSSessionOption.

$PSSessionOption = New-PSSessionOption -NoCompression

Aby użyć zmiennej $PSSessionOption preferencji w każdej sesji programu PowerShell, dodaj polecenie, które tworzy zmienną New-PSSessionOption$PSSessionOption do profilu programu PowerShell. Aby uzyskać więcej informacji, zobacz about_Profiles.

Można ustawić opcje niestandardowe dla określonej sesji zdalnej. Ustawione opcje mają pierwszeństwo przed wartościami domyślnymi systemu i wartością zmiennej $PSSessionOption preferencji.

Aby ustawić niestandardowe opcje sesji, użyj New-PSSessionOption polecenia cmdlet , aby utworzyć obiekt PSSessionOption . Następnie użyj obiektu PSSessionOption jako wartości parametru SessionOption w poleceniach cmdlet, które tworzą sesję, taką jak New-PSSession, Enter-PSSessioni Invoke-Command.

$Transcript

Start-Transcript Służy do określania nazwy i lokalizacji pliku transkrypcji. Jeśli nie określisz wartości parametru Path , Start-Transcript użyje ścieżki w wartości zmiennej globalnej $Transcript . Jeśli ta zmienna nie została utworzona, Start-Transcript zapisuje transkrypcje w następującej lokalizacji przy użyciu nazwy domyślnej.

  • Lokalizacja domyślna: $HOME\Documents
  • Domyślna nazwa pliku: PowerShell_transcript.<computername>.<random>.<timestamp>.txt

$VerbosePreference

Określa sposób reagowania programu PowerShell na pełne komunikaty generowane przez skrypt, polecenie cmdlet lub dostawcę, takie jak komunikaty generowane przez polecenie cmdlet Write-Verbose . Pełne komunikaty opisują akcje wykonywane w celu wykonania polecenia.

Domyślnie pełne komunikaty nie są wyświetlane, ale można zmienić to zachowanie, zmieniając wartość .$VerbosePreference

Zmienna $VerbosePreference przyjmuje jedną z ActionPreference wartości wyliczenia: SilentlyContinue, Stop, Continue, Inquire, Ignore lub Suspend.

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

  • Zatrzymaj: wyświetla pełny komunikat i komunikat o błędzie, a następnie zatrzymuje wykonywanie.
  • Zapytanie: wyświetla pełny komunikat, a następnie wyświetla monit z pytaniem, czy chcesz kontynuować.
  • Kontynuuj: wyświetla pełny komunikat, a następnie kontynuuje wykonywanie.
  • SilentlyContinue: (Wartość domyślna) Nie wyświetla pełnej wiadomości. Kontynuuje wykonywanie.

Możesz użyć pełnego wspólnego parametru polecenia cmdlet, aby wyświetlić lub ukryć pełne komunikaty dla określonego polecenia. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Przykłady

W tych przykładach pokazano efekt różnych wartości $VerbosePreference i parametru Verbose , aby zastąpić wartość preferencji.

W tym przykładzie przedstawiono efekt wartości SilentlyContinue , która jest wartością domyślną. Polecenie używa parametru Message, ale nie zapisuje komunikatu w konsoli programu PowerShell.

Write-Verbose -Message "Verbose message test."

Gdy jest używany parametr Verbose, komunikat jest zapisywany.

Write-Verbose -Message "Verbose message test." -Verbose

VERBOSE: Verbose message test.

W tym przykładzie pokazano efekt wartości Kontynuuj . Zmienna jest ustawiona $VerbosePreference na Kontynuuj , a komunikat jest wyświetlany.

$VerbosePreference = "Continue"
Write-Verbose -Message "Verbose message test."

VERBOSE: Verbose message test.

W tym przykładzie użyto parametru Verbose z wartością$false, która zastępuje wartość Kontynuuj. Komunikat nie jest wyświetlany.

Write-Verbose -Message "Verbose message test." -Verbose:$false

W tym przykładzie pokazano efekt wartości Stop . Zmienna jest ustawiona $VerbosePreference na Wartość Zatrzymaj , a komunikat jest wyświetlany. Polecenie zostało zatrzymane.

$VerbosePreference = "Stop"
Write-Verbose -Message "Verbose message test."

VERBOSE: Verbose message test.
Write-Verbose : The running command stopped because the preference variable
  "VerbosePreference" or common parameter is set to Stop: Verbose message test.
At line:1 char:1
+ Write-Verbose -Message "Verbose message test."

W tym przykładzie użyto parametru Verbose z wartością$false, która zastępuje wartość Stop. Komunikat nie jest wyświetlany.

Write-Verbose -Message "Verbose message test." -Verbose:$false

W tym przykładzie pokazano efekt wartości Inquire . Zmienna jest ustawiona $VerbosePreference na Inquire. Zostanie wyświetlony komunikat i zostanie wyświetlony monit o potwierdzenie.

$VerbosePreference = "Inquire"
Write-Verbose -Message "Verbose message test."

VERBOSE: Verbose message test.

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend
[?] Help (default is "Y"):

W tym przykładzie użyto parametru Verbose z wartością$false, która zastępuje wartość Inquire. Użytkownik nie jest monitowany i komunikat nie jest wyświetlany.

Write-Verbose -Message "Verbose message test." -Verbose:$false

$WarningPreference

Określa sposób reagowania programu PowerShell na komunikaty ostrzegawcze generowane przez skrypt, polecenie cmdlet lub dostawcę, takie jak komunikaty generowane przez polecenie cmdlet Write-Warning .

Domyślnie komunikaty ostrzegawcze są wyświetlane i wykonywanie jest kontynuowane, ale można zmienić to zachowanie, zmieniając wartość $WarningPreference.

Zmienna $WarningPreference przyjmuje jedną z ActionPreference wartości wyliczenia: SilentlyContinue, Stop, Continue, Inquire, Ignore lub Suspend.

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

  • Zatrzymaj: wyświetla komunikat ostrzegawczy i komunikat o błędzie, a następnie zatrzymuje wykonywanie.
  • Pytanie: wyświetla komunikat ostrzegawczy, a następnie monituje o uprawnienie do kontynuowania.
  • Kontynuuj: (ustawienie domyślne) Wyświetla komunikat ostrzegawczy, a następnie kontynuuje wykonywanie.
  • SilentlyContinue: nie wyświetla komunikatu ostrzegawczego. Kontynuuje wykonywanie.

Typowego parametru WarningAction polecenia cmdlet można użyć, aby określić sposób, w jaki program PowerShell reaguje na ostrzeżenia z określonego polecenia. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Przykłady

W tych przykładach pokazano efekt różnych wartości .$WarningPreference Parametr WarningAction zastępuje wartość preferencji.

W tym przykładzie pokazano efekt wartości domyślnej, Kontynuuj.

$m = "This action can delete data."
Write-Warning -Message $m

WARNING: This action can delete data.

W tym przykładzie użyto parametru WarningAction z wartością SilentlyContinue , aby pominąć ostrzeżenie. Komunikat nie jest wyświetlany.

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction SilentlyContinue

W tym przykładzie zmienna zmienia $WarningPreference się na wartość SilentlyContinue . Komunikat nie jest wyświetlany.

$WarningPreference = "SilentlyContinue"
$m = "This action can delete data."
Write-Warning -Message $m

W tym przykładzie użyto parametru WarningAction , aby zatrzymać się po wygenerowaniu ostrzeżenia.

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction Stop

WARNING: This action can delete data.
Write-Warning : The running command stopped because the preference variable
  "WarningPreference" or common parameter is set to Stop:
    This action can delete data.
At line:1 char:1
+ Write-Warning -Message $m -WarningAction Stop

W tym przykładzie zmienna jest $WarningPreference zmieniana na wartość Inquire. Użytkownik jest monitowany o potwierdzenie.

$WarningPreference = "Inquire"
$m = "This action can delete data."
Write-Warning -Message $m

WARNING: This action can delete data.

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend
[?] Help (default is "Y"):

W tym przykładzie użyto parametru WarningAction z wartością SilentlyContinue. Polecenie kontynuuje wykonywanie i nie jest wyświetlany żaden komunikat.

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction SilentlyContinue

Ten przykład zmienia $WarningPreference wartość na Zatrzymaj.

$WarningPreference = "Stop"
$m = "This action can delete data."
Write-Warning -Message $m

WARNING: This action can delete data.
Write-Warning : The running command stopped because the preference variable
  "WarningPreference" or common parameter is set to Stop:
    This action can delete data.
At line:1 char:1
+ Write-Warning -Message $m

W tym przykładzie użyto funkcji WarningAction z wartością Inquire . Gdy wystąpi ostrzeżenie, użytkownik zostanie wyświetlony monit.

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction Inquire

WARNING: This action can delete data.

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend
[?] Help (default is "Y"):

$WhatIfPreference

Określa, czy funkcja WhatIf jest automatycznie włączona dla każdego polecenia, które go obsługuje. Po włączeniu funkcji WhatIf polecenie cmdlet zgłasza oczekiwany efekt polecenia, ale nie wykonuje polecenia.

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

  • Fałsz (0, nie jest włączony): (ustawienie domyślne) WhatIf nie jest automatycznie włączone. Aby ją włączyć ręcznie, użyj parametru WhatIf polecenia cmdlet.
  • True (1, enabled): WhatIf jest automatycznie włączone dla dowolnego polecenia, które go obsługuje. Użytkownicy mogą użyć parametru WhatIf z wartością False , aby wyłączyć go ręcznie, na przykład -WhatIf:$false.

Przykłady

W tych przykładach pokazano efekt różnych wartości .$WhatIfPreference Pokazują one, jak za pomocą parametru WhatIf zastąpić wartość preferencji dla określonego polecenia.

W tym przykładzie pokazano efekt zmiennej $WhatIfPreference ustawionej na wartość domyślną False. Użyj polecenia Get-ChildItem , aby sprawdzić, czy plik istnieje. Remove-Item Usuwa plik. Po usunięciu pliku można zweryfikować usunięcie za pomocą polecenia Get-ChildItem.

Get-ChildItem -Path .\test.txt
Remove-Item -Path ./test.txt

    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           9/13/2019    10:53             10 test.txt

Get-ChildItem -Path .\test.txt

Get-ChildItem : Cannot find path 'C:\Test\test.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -File test.txt

W tym przykładzie pokazano efekt użycia parametru WhatIf , gdy wartość $WhatIfPreference to False.

Sprawdź, czy plik istnieje.

Get-ChildItem -Path .\test2.txt

    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           2/28/2019    17:06             12 test2.txt

Użyj parametru WhatIf , aby określić wynik próby usunięcia pliku.

Remove-Item -Path .\test2.txt -WhatIf

What if: Performing the operation "Remove File" on target "C:\Test\test2.txt".

Sprawdź, czy plik nie został usunięty.

Get-ChildItem -Path .\test2.txt

    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           2/28/2019    17:06             12 test2.txt

W tym przykładzie pokazano efekt zmiennej $WhatIfPreference ustawionej na wartość True. Gdy używasz Remove-Item polecenia do usunięcia pliku, zostanie wyświetlona ścieżka pliku, ale plik nie zostanie usunięty.

Spróbuj usunąć plik. Zostanie wyświetlony komunikat o tym, co się stanie w przypadku Remove-Item uruchomienia, ale plik nie zostanie usunięty.

$WhatIfPreference = "True"
Remove-Item -Path .\test2.txt

What if: Performing the operation "Remove File" on target "C:\Test\test2.txt".

Użyj polecenia Get-ChildItem , aby sprawdzić, czy plik nie został usunięty.

Get-ChildItem -Path .\test2.txt

    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           2/28/2019    17:06             12 test2.txt

W tym przykładzie pokazano, jak usunąć plik, gdy wartość ma wartość $WhatIfPreferenceTrue. Używa parametru WhatIf z wartością $false. Użyj polecenia Get-ChildItem , aby sprawdzić, czy plik został usunięty.

Remove-Item -Path .\test2.txt -WhatIf:$false
Get-ChildItem -Path .\test2.txt

Get-ChildItem : Cannot find path 'C:\Test\test2.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -Path .\test2.txt

Poniżej przedstawiono przykłady Get-Process polecenia cmdlet, które nie obsługuje funkcji WhatIf i Stop-Process które obsługują whatIf. Wartość $WhatIfPreference zmiennej to True.

Get-Process nie obsługuje funkcji WhatIf. Po wykonaniu polecenia zostanie wyświetlony proces Winword .

Get-Process -Name Winword

 NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
    130   119.84     173.38       8.39   15024   4 WINWORD

Stop-Process program obsługuje whatIf. Proces Winword nie jest zatrzymany.

Stop-Process -Name Winword

What if: Performing the operation "Stop-Process" on target "WINWORD (15024)".

Zachowanie WhatIf można zastąpić Stop-Processprzy użyciu parametru WhatIf z wartością $false. Proces Winword jest zatrzymany.

Stop-Process -Name Winword -WhatIf:$false

Aby sprawdzić, czy proces Winword został zatrzymany, użyj polecenia Get-Process.

Get-Process -Name Winword

Get-Process : Cannot find a process with the name "Winword".
  Verify the process name and call the cmdlet again.
At line:1 char:1
+ Get-Process -Name Winword

Zobacz też