Udostępnij za pomocą

Informacje o parametrach ActivityCommonParameters

KRÓTKI OPIS

Opisuje parametry, które dodaje przepływ pracy programu Windows PowerShell do działań.

DŁUGI OPIS

Przepływ pracy programu Windows PowerShell dodaje typowe parametry działania do działań pochodzących z klasy bazowej PSActivity. Ta kategoria obejmuje działanie InlineScript i polecenia cmdlet programu Windows PowerShell, które są implementowane jako działania, takie jak Get-Process i Get-WinEvent.

Typowe parametry działania nie są prawidłowe dla działań Suspend-Workflow i Checkpoint-Workflow i nie są dodawane do poleceń cmdlet ani wyrażeń, które przepływ pracy programu Windows PowerShell jest automatycznie uruchamiany w bloku skryptu InlineScript lub podobnym działaniu. Typowe parametry działania są dostępne w działaniu InlineScript, ale nie w poleceniach w bloku skryptu InlineScript.

Kilka typowych parametrów działania to również typowe parametry przepływu pracy lub typowe parametry programu Windows PowerShell. Inne typowe parametry działania są unikatowe dla działań.

Aby uzyskać informacje o typowych parametrach przepływu pracy, zobacz about_WorkflowCommonParameters. Aby uzyskać informacje o typowych parametrach programu Windows PowerShell, zobacz about_CommonParameters.

LISTA TYPOWYCH PARAMETRÓW DZIAŁANIA

AppendOutput                      PSDebug
Debug                             PSDisableSerialization
DisplayName                       PSDisableSerializationPreference
ErrorAction                       PSError
Input                             PSPersist
MergeErrorToOutput                PSPort
PSActionRetryCount                PSProgress
PSActionRetryIntervalSec          PSProgressMessage
PSActionRunningTimeoutSec         PSRemotingBehavior
PSApplicationName                 PSRequiredModules
PSAuthentication                  PSSessionOption
PSCertificateThumbprint           PSUseSSL
PSComputerName                    PSVerbose
PSConfigurationName               PSWarning
PSConnectionRetryCount            Result
PSConnectionRetryIntervalSec      UseDefaultInput
PSConnectionURI                   Verbose
PSCredential                      WarningAction

OPISY PARAMETRÓW

W tej sekcji opisano typowe parametry działania.

Wartość logiczna AppendOutput <>

Wartość polecenia $True dodaje dane wyjściowe działania do wartości zmiennej. Wartość $False nie ma wpływu. Domyślnie przypisanie wartości do zmiennej zastępuje wartość zmiennej.

Na przykład następujące polecenia dodają obiekt procesu do obiektu usługi w zmiennej $x .

Workflow Test-Workflow
{
    $x = Get-Service
    $x = Get-Process -AppendOutput $true
}

Ten parametr jest przeznaczony dla przepływów pracy opartych na języku XAML. W przepływach pracy skryptów można również użyć operatora przypisania +=, aby dodać dane wyjściowe do wartości zmiennej, jak pokazano w poniższym przykładzie.

Workflow Test-Workflow
{
    $x = Get-Service
    $x += Get-Process
}

Parametr przełącznika debugowania <>

Wyświetla szczegóły na poziomie programisty dotyczące operacji wykonywanej przez polecenie. Parametr Debug zastępuje wartość zmiennej $DebugPreference dla bieżącego polecenia. Ten parametr działa tylko wtedy, gdy polecenie generuje komunikaty debugowania. Ten parametr jest również typowym parametrem programu Windows PowerShell.

Ciąg DisplayName <>

Określa przyjazną nazwę działania. Wartość DisplayName jest wyświetlana na pasku postępu podczas uruchamiania przepływu pracy oraz w wartości właściwości Progress zadania przepływu pracy. Jeśli parametr PSProgressMessage jest również uwzględniony w poleceniu, zawartość paska postępu jest wyświetlana w <formacie DisplayName>:<PSProgressMessage> .

ErrorAction <ActionPreference (Preferencja działania)>

Określa, jak działanie reaguje na błąd niepowodujący zakończenia polecenia. Nie ma to wpływu na błędy zakończenia. Ten parametr działa tylko wtedy, gdy polecenie generuje błąd niepowodujący zakończenia, taki jak te z polecenia cmdlet Write-Error. Parametr ErrorAction zastępuje wartość zmiennej $ErrorActionPreference dla bieżącego polecenia. Ten parametr jest również typowym parametrem programu Windows PowerShell.

Prawidłowe wartości:

  • Kontynuować. Wyświetla komunikat o błędzie i kontynuuje wykonywanie polecenia. "Kontynuuj" jest wartością domyślną.

  • Zignoruj. Pomija komunikat o błędzie i kontynuuje wykonywanie polecenia. W przeciwieństwie do SilentlyContinue, Ignore nie dodaje komunikatu o błędzie do zmiennej automatycznej $Error. Wartość Ignoruj została wprowadzona w programie Windows PowerShell 3.0.

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

  • Zawiesić. Automatycznie zawiesza zadanie przepływu pracy, aby umożliwić dalsze badanie. Po zbadaniu można wznowić przepływ pracy.

  • Po cichuKontynuuj. Pomija komunikat o błędzie i kontynuuje wykonywanie polecenia.

  • Zatrzymaj się. Wyświetla komunikat o błędzie i zatrzymuje wykonywanie polecenia.

Obiekt wejściowy <[]>

Przesyła kolekcję obiektów do działania. Jest to alternatywa dla obiektów potokowych do działania pojedynczo.

MergeErrorToOutput <, wartość logiczna>

Wartość dodawania $True błędów do strumienia wyjściowego. Wartość nie $False ma wpływu. Użyj tego parametru ze słowami kluczowymi Parallel i ForEach -Parallel , aby zbierać błędy i dane wyjściowe z wielu poleceń równoległych w jednej kolekcji.

PSActionRetryCount <Int32>

Próbuje wielokrotnie uruchamiać działanie, jeśli pierwsza próba zakończy się niepowodzeniem. Wartość domyślna, 0, nie ponawia próby.

PSActionRetryIntervalSec <Int32>

Określa interwał między ponownymi próbami akcji w sekundach. Wartość domyślna, 0, natychmiast ponawia próbę wykonania akcji. Ten parametr jest prawidłowy tylko wtedy, gdy parametr PSActionRetryCount jest również używany w poleceniu.

PSActionRunningTimeoutSec <Int32>

Określa, jak długo działanie może być uruchamiane na każdym komputerze docelowym. Jeśli działanie nie zostanie ukończone przed upływem limitu czasu, przepływ pracy programu Windows PowerShell generuje błąd zakończenia i zatrzymuje przetwarzanie przepływu pracy na komputerze docelowym, którego dotyczy problem.

Wartość logiczna PSAllowRedirection <>

Wartość $True umożliwia przekierowanie połączenia do komputerów docelowych. Wartość $False nie ma żadnego wpływu. Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

W przypadku korzystania z parametru PSConnectionURI zdalne miejsce docelowe może zwrócić instrukcję przekierowania do innego identyfikatora URI. Domyślnie program Windows PowerShell nie przekierowuje połączeń, ale można użyć parametru PSAllowRedirection o wartości $True, aby zezwolić na przekierowanie połączenia do komputera docelowego.

Można również ograniczyć liczbę przekierowań połączenia, ustawiając właściwość $PSSessionOption MaximumConnectionRedirectionCount zmiennej preferencji lub właściwość MaximumConnectionRedirectionCount wartości parametru SSessionOption poleceń cmdlet, które tworzą sesję. Wartość domyślna to 5.

Ciąg PSApplicationName <>

Określa segment nazwy aplikacji identyfikatora URI połączenia, który jest używany do łączenia się z komputerami docelowymi. Użyj tego parametru, aby określić nazwę aplikacji, jeśli nie używasz parametru ConnectionURI w poleceniu . Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

Wartość domyślna to wartość zmiennej $PSSessionApplicationName preferencji na komputerze docelowym. Jeśli ta zmienna preferencji nie jest zdefiniowana, wartość domyślna to WSMAN. Ta wartość jest odpowiednia dla większości zastosowań. Aby uzyskać więcej informacji, zobacz about_Preference_Variables.

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

Uwierzytelnianie PSAuthenticationMechanism <>

Określa mechanizm używany do uwierzytelniania poświadczeń użytkownika podczas nawiązywania połączenia z komputerami docelowymi. Prawidłowe wartości to Default, Basic, Credssp, Digest, Kerberos, Negotiate i NegotiateWithImplicitCredential. Wartość domyślna to Default. Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

Aby uzyskać informacje o wartościach tego parametru, zobacz opis wyliczenia System.Management.Automation.Runspaces.AuthenticationMechanism w witrynie MSDN.

Ostrzeżenie

Uwierzytelnianie dostawcy usług zabezpieczeń poświadczeń (CredSSP), w którym poświadczenia użytkownika są przekazywane do komputera zdalnego do uwierzytelnienia, jest przeznaczone dla poleceń wymagających uwierzytelniania w więcej niż jednym zasobie, takich jak uzyskiwanie dostępu do zdalnego udziału sieciowego. Ten mechanizm zwiększa ryzyko bezpieczeństwa operacji zdalnej. W przypadku naruszenia zabezpieczeń komputera zdalnego poświadczenia przekazywane do niego mogą służyć do kontrolowania sesji sieciowej.

PSCertificateThumbprint <String>

Określa cyfrowy certyfikat klucza publicznego (X509) konta użytkownika, które ma uprawnienia do wykonania tej akcji. Wprowadź odcisk palca certyfikatu. Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

Certyfikaty są używane w uwierzytelnianiu opartym na certyfikatach klienta. Można je mapować tylko na lokalne konta użytkowników; nie działają z kontami domeny.

Aby uzyskać certyfikat, użyj poleceń cmdlet Get-Item lub Get-ChildItem na dysku Windows PowerShell Cert:.

Ciąg PSComputerName <[]>

Określa komputery docelowe, na których jest uruchamiane działanie. Wartość domyślna to komputer lokalny. Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

Wpisz nazwę NETBIOS, adres IP lub w pełni kwalifikowaną nazwę domeny jednego lub kilku komputerów na liście rozdzielanej przecinkami. Aby określić komputer lokalny, wpisz nazwę komputera, "localhost" lub kropkę (.).

Aby uwzględnić komputer lokalny w wartości parametru PSComputerName, otwórz program Windows PowerShell z opcją "Uruchom jako administrator".

Jeśli ten parametr zostanie pominięty w poleceniu lub jego wartość to $null lub pusty ciąg, celem przepływu pracy jest komputer lokalny, a komunikacja zdalna programu Windows PowerShell nie jest używana do uruchamiania polecenia.

Aby użyć adresu IP w wartości parametru ComputerName, polecenie musi zawierać parametr PSCredential. Ponadto należy skonfigurować komputer pod kątem transportu HTTPS lub adres IP komputera zdalnego musi znajdować się na liście Zaufanych Hostów usługi WinRM na komputerze lokalnym. Aby uzyskać instrukcje dotyczące dodawania nazwy komputera do listy TrustedHosts, zobacz "How to Add a Computer to the Trusted Host List" (Jak dodać komputer do listy zaufanych hostów) w about_Remote_Troubleshooting.

Ciąg PSConfigurationName <>

Określa konfiguracje sesji używane do tworzenia sesji na komputerach docelowych. Wprowadź nazwę konfiguracji sesji na komputerach docelowych (nie na komputerze, na którym jest uruchomiony przepływ pracy. Wartość domyślna to Microsoft.PowerShell. Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

PSConnectionRetryCount <UInt>

Określa maksymalną liczbę prób nawiązania połączenia z każdym komputerem docelowym, jeśli pierwsza próba połączenia zakończy się niepowodzeniem. Wprowadź liczbę z zakresu od 1 do 4 294 967 295 (UInt.MaxValue). Wartość domyślna, zero (0), oznacza brak ponownych prób. Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

PSConnectionRetryIntervalSec <UInt>

Określa opóźnienie między próbami ponawiania próby połączenia w sekundach. Wartość domyślna to zero (0). Ten parametr jest prawidłowy tylko wtedy, gdy wartość PSConnectionRetryCount wynosi co najmniej 1. Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

PSConnectionURI <System.Uri>

Określa jednolity identyfikator zasobu (URI), który definiuje punkt końcowy połączenia dla działania na komputerze docelowym. Identyfikator URI musi być w pełni kwalifikowany. Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

Format tego ciągu jest następujący:

<Transport>://<ComputerName>:<Port>/<ApplicationName>

Wartość domyślna to https://localhost:5985/WSMAN.

Jeśli nie określisz identyfikatora PSConnectionURI, możesz użyć parametrów PSUseSSL, PSComputerName, PSPort i PSApplicationName, aby określić wartości PSConnectionURI.

Prawidłowe wartości segmentu Transport identyfikatora URI to HTTP i HTTPS. Jeśli określisz identyfikator URI połączenia z segmentem Transport, ale nie określisz portu, sesja zostanie utworzona z portami standardów: 80 dla protokołu HTTP i 443 dla protokołu HTTPS. Aby użyć domyślnych portów komunikacji zdalnej programu Windows PowerShell, określ port 5985 dla protokołu HTTP lub 5986 dla protokołu HTTPS.

PSCredential PSCredential <>

Określa konto użytkownika, które ma uprawnienia do uruchamiania działania na komputerze docelowym. Wartość domyślna to bieżący użytkownik. Ten parametr jest prawidłowy tylko wtedy, gdy parametr PSComputerName jest uwzględniony w poleceniu. Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

Wpisz nazwę użytkownika, taką jak "Użytkownik01" lub "Domena01\Użytkownik01", lub wprowadź zmienną, która zawiera obiekt PSCredential, taki jak obiekt zwracany przez Get-Credential cmdlet. Jeśli wprowadzisz tylko nazwę użytkownika, zostanie wyświetlony monit o podanie hasła.

PSDebug <PSDataCollection[DebugRecord]>

Dodaje komunikaty debugowania z działania do określonej kolekcji rekordów debugowania, zamiast zapisywać komunikaty debugowania w konsoli lub do wartości właściwości Debug zadania przepływu pracy. Możesz dodać komunikaty debugowania z wielu działań do tego samego obiektu kolekcji rekordów debugowania.

Aby użyć tego wspólnego parametru działania, użyj polecenia cmdlet New-Object, aby utworzyć obiekt PSDataCollection z typem DebugRecord i zapisać obiekt w zmiennej. Następnie użyj zmiennej jako wartości parametru PSDebug co najmniej jednego działania, jak pokazano w poniższym przykładzie.

Workflow Test-Workflow
{
    $debugCollection = New-Object -Type `
    System.Management.Automation.PSDataCollection[System.Management.Automation.DebugRecord]
    InlineScript {\Server01\Share01\Get-AssetData.ps1} -PSDebug $debugCollection -Debug $True
    InlineScript {\Server01\Share01\Set-AssetData.ps1} -PSDebug $debugCollection -Debug $True
    if ($debugCollection -like "Missing") { ...}
}

WARTOŚĆ logiczna PSDisableSerialization <>

Przekierowuje działanie tak, aby zwracało obiekty "live" (nie serializowane) do przepływu pracy. Wynikowe obiekty mają metody, a także właściwości, ale nie można ich zapisać po utworzeniu punktu kontrolnego.

PSDisableSerializationPreference <Wartość logiczna>

Stosuje odpowiednik parametru PSDisableSerialization do całego przepływu pracy, a nie tylko do działania. Dodanie tego parametru zwykle nie jest zalecane, ponieważ nie można wznowić ani utrwycić przepływu pracy, który nie serializuje swoich obiektów.

Prawidłowe wartości:

  • (Domyślnie) Jeśli zostanie pominięty, a parametr PSDisableSerialization nie zostanie dodany do działania, obiekty zostaną serializowane.

  • $True. Kieruje wszystkie działania w przepływie pracy, aby zwracały obiekty "live" (nie serializowane). Wynikowe obiekty mają metody, a także właściwości, ale nie można ich zapisać po utworzeniu punktu kontrolnego.

  • $False. Obiekty przepływu pracy są serializowane.

PSError <PSDataCollection[RekordBłędu]>

Dodaje komunikaty o błędach z działania do określonej kolekcji rekordów błędów, zamiast zapisywać komunikaty o błędach w konsoli lub w wartości właściwości Error zadania przepływu pracy. Możesz dodać komunikaty o błędach z wielu działań do tego samego obiektu zbierania rekordów błędów.

Aby użyć tego wspólnego parametru działania, użyj New-Object polecenia cmdlet, aby utworzyć obiekt PSDataCollection z typem ErrorRecord i zapisać obiekt w zmiennej. Następnie użyj zmiennej jako wartości parametru PSError co najmniej jednego działania, jak pokazano w poniższym przykładzie.

Workflow Test-Workflow
{
   $typeName = "System.Management.Automation.PSDataCollection"
   $typeName += '[System.Management.Automation.ErrorRecord]'
   $ec = New-Object $typeName
   InlineScript {\Server01\Share01\Get-AssetData.ps1} -PSError $ec
   InlineScript {\Server01\Share01\Set-AssetData.ps1} -PSError $ec
   if ($ec.Count -gt 2)
   {
      # Do Some Work.
   }
}

PSPersist <— wartość logiczna>

Pobiera punkt kontrolny po działaniu. Ten punkt kontrolny jest dodatkiem do wszystkich punktów kontrolnych określonych w przepływie pracy. Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

"Punkt kontrolny" lub "punkt trwałości" to migawka stanu przepływu pracy i danych przechwyconych podczas uruchamiania przepływu pracy i jest zapisywana w magazynie trwałości na dysku. Przepływ pracy programu Windows PowerShell używa zapisanych danych do wznowienia zawieszonego lub przerwanego przepływu pracy z ostatniego punktu trwałości, a nie do ponownego uruchomienia przepływu pracy.

Prawidłowe wartości:

  • (Ustawienie domyślne) W przypadku pominięcia tego parametru żadne punkty kontrolne nie zostaną dodane. Punkty kontrolne są wykonywane na podstawie ustawień przepływu pracy.

  • $True. Pobiera punkt kontrolny po zakończeniu działania. Ten punkt kontrolny jest dodatkiem do wszystkich punktów kontrolnych określonych w przepływie pracy.

  • $False. Nie są dodawane żadne punkty kontrolne. Punkty kontrolne są wykonywane tylko wtedy, gdy są określone w przepływie pracy.

PSPort <Int32>

Określa port sieciowy na komputerach docelowych. Domyślne porty to 5985 (port Usługi WinRM dla protokołu HTTP) i 5986 (port Usługi WinRM dla protokołu HTTPS). Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

Nie należy używać parametru PSPort, chyba że jest to konieczne. Port ustawiony w poleceniu ma zastosowanie do wszystkich komputerów lub sesji, na których jest uruchamiane polecenie. Ustawienie alternatywnego portu może uniemożliwić uruchomienie polecenia na wszystkich komputerach. Przed użyciem portu alternatywnego należy skonfigurować odbiornik WinRM na komputerze zdalnym do nasłuchiwania na tym porcie.

PSProgress <PSDataCollection[ProgressRecord]>

Dodaje komunikaty o postępie z działania do określonej kolekcji rekordów postępu, zamiast zapisywać komunikaty o postępie w konsoli lub w wartości właściwości Progress zadania przepływu pracy. Komunikaty postępu można dodawać z wielu działań do tego samego obiektu kolekcji rekordów postępu.

Ciąg PSProgressMessage <>

Określa przyjazny opis działania. Wartość PSProgressMessage jest wyświetlana na pasku postępu podczas uruchamiania przepływu pracy. Jeśli parametr DisplayName jest również uwzględniony w poleceniu, zawartość paska postępu jest wyświetlana w <formacie DisplayName>:<PSProgressMessage> .

Ten parametr jest szczególnie przydatny do identyfikowania działań w bloku skryptu ForEach -Parallel. Bez tego komunikatu działania we wszystkich gałęziach równoległych są identyfikowane przy użyciu tej samej nazwy.

PSRemotingBehavior RemotingBehavior <>

Określa, jak komunikacja zdalna jest zarządzana, gdy działanie jest uruchamiane na komputerach docelowych. Program PowerShell jest domyślny.

Prawidłowe wartości to:

  • Brak: Działanie nie jest uruchamiane na komputerach zdalnych.

  • PowerShell: komunikacja zdalna programu Windows PowerShell służy do uruchamiania działania na komputerach docelowych.

  • Niestandardowe: działanie obsługuje własny typ komunikacji zdalnej. Ta wartość jest prawidłowa, gdy polecenie cmdlet, które jest implementowane jako działanie, ustawia wartość atrybutu RemotingCapability na SupportedByCommand, a polecenie zawiera parametr ComputerName .

PsRequiredModules <String[]>

Importuje określone moduły przed uruchomieniem polecenia . Wprowadź nazwy modułów. Moduły muszą być zainstalowane na komputerze docelowym.

Moduły, które są zainstalowane w ścieżce określonej w zmiennej środowiskowej PSModulePath, są automatycznie importowane przy pierwszym użyciu dowolnego polecenia w module. Ten parametr służy do importowania modułów, które nie znajdują się w lokalizacji PSModulePath.

Ponieważ każde działanie w przepływie pracy jest uruchamiane we własnej sesji, polecenie Import-Module importuje moduł tylko do sesji, w której jest uruchamiany. Nie importuje modułu do sesji, w których są uruchamiane inne działania.

PSSessionOption <PSSessionOption>

Ustawia zaawansowane opcje sesji na komputery docelowe. Wprowadź obiekt PSSessionOption, taki jak obiekt utworzony za pomocą polecenia cmdlet New-PSSessionOption. Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

Wartości domyślne opcji sesji są określane przez wartość zmiennej $PSSessionOption preferencji, jeśli jest ustawiona. W przeciwnym razie sesja używa wartości określonych w konfiguracji sesji.

Opis opcji sesji, w tym wartości domyślnych, można znaleźć w temacie pomocy dotyczącej polecenia cmdlet New-PSSessionOption New-PSSessionOption.

Aby uzyskać więcej informacji na temat zmiennej preferencji $PSSessionOption, zobacz about_Preference_Variables.

PSUseSSL <— wartość logiczna>

Wartość $True używa protokołu SSL (Secure Sockets Layer) w celu nawiązania połączenia z komputerem docelowym. Domyślnie protokół SSL nie jest używany. Wartość $False nie ma żadnego wpływu. Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

WS-Management szyfruje całą zawartość programu Windows PowerShell przesyłaną przez sieć. UseSSL to dodatkowa ochrona, która wysyła dane przez protokół HTTPS, a nie HTTP. Jeśli używasz tego parametru, ale protokół SSL nie jest dostępny na porcie używanym dla polecenia, polecenie zakończy się niepowodzeniem.

PSVerbose <PSDataCollection[VerboseRecord]>

Dodaje pełne komunikaty z działania do określonej pełnej kolekcji rekordów, zamiast zapisywać pełne komunikaty w konsoli lub do wartości właściwości Verbose zadania przepływu pracy. Możesz dodać pełne komunikaty z wielu działań do tego samego pełnego obiektu kolekcji rekordów.

PSWarning <PSDataCollection[WarningRecord]>

Dodaje komunikaty ostrzegawcze z działania do określonej kolekcji rekordów ostrzeżeń, zamiast zapisywać komunikaty ostrzegawcze w konsoli lub do wartości właściwości Ostrzeżenie zadania przepływu pracy. Komunikaty ostrzegawcze można dodać z wielu działań do tego samego obiektu kolekcji rekordów ostrzeżeń.

Wynik

Ten parametr jest prawidłowy tylko w przepływach pracy XAML.

UseDefaultInput <, wartość logiczna>

Akceptuje wszystkie dane wejściowe przepływu pracy jako dane wejściowe działania według wartości.

Na przykład działanie Get-Process w poniższym przykładowym przepływie pracy używa wspólnego parametru działania UseDefaultInput w celu uzyskania danych wejściowych, które są przekazywane do przepływu pracy. Po uruchomieniu przepływu pracy z danymi wejściowymi dane wejściowe są używane przez działanie.

workflow Test-Workflow
{
    Get-Service -UseDefaultInput $True
}

PS C:> Test-Workflow -InputObject WinRm

Status   Name        DisplayName                            PSComputerName
------   ----        -----------                            --------------
Running  winrm       Windows Remote Management (WS-Manag... localhost

<Pełne parametry przełącznika>

Wyświetla szczegółowe informacje o operacji wykonywanej przez polecenie . Te informacje przypominają informacje w śladzie lub w dzienniku transakcji. Parametr Verbose zastępuje wartość zmiennej $VerbosePreference dla bieżącego polecenia. Ten parametr działa tylko wtedy, gdy polecenie generuje pełny komunikat. Ten parametr jest również typowym parametrem programu Windows PowerShell.

OstrzeżenieAkcja <Preferencja działania>

Określa sposób reagowania działania na ostrzeżenie. "Kontynuuj" jest wartością domyślną. Parametr WarningAction zastępuje wartość zmiennej $WarningPreference dla bieżącego polecenia. Ten parametr działa tylko wtedy, gdy polecenie generuje komunikat ostrzegawczy. Ten parametr jest również typowym parametrem programu Windows PowerShell.

Prawidłowe wartości:

  • Po cichuKontynuuj. Pomija komunikat ostrzegawczy i kontynuuje wykonywanie polecenia.

  • Kontynuować. Wyświetla komunikat ostrzegawczy i kontynuuje wykonywanie polecenia. "Kontynuuj" jest wartością domyślną.

  • Zapytać. Wyświetla komunikat ostrzegawczy i monituje o potwierdzenie przed kontynuowaniem wykonywania. Ta wartość jest rzadko używana.

  • Zatrzymaj się. Wyświetla komunikat ostrzegawczy i zatrzymuje wykonywanie polecenia.

Uwaga / Notatka

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

PRZYKŁADY

Typowe parametry działania są bardzo przydatne. Na przykład można użyć parametru PSComputerName, aby uruchomić określone działania tylko na podzbiorze komputerów docelowych.

Możesz też użyć parametrów PSConnectionRetryCount i PSConnectionRetryIntervalSec, aby dostosować wartości ponawiania prób dla określonych działań.

W poniższym przykładzie pokazano, jak używać typowych parametrów działania PSComputerName do uruchamiania działania Get-EventLog tylko na komputerach w określonej domenie.

Workflow Test-Workflow
{
    $UserDomain = Get-Content -Path '.\UserComputers.txt'
    $Log = (Get-EventLog -LogName "Windows PowerShell" `
      -PSComputerName $UserDomain)

    if ($Log)
    {
        # Do Work Here.
    }
}

ZOBACZ TEŻ

about_Workflowsabout_WorkflowCommonParameters

  • Last updated on