about_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łania 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 w działaniach 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 wbudowanego lub podobnej aktywności. 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ść $DebugPreference zmiennej 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, gdy przepływ pracy jest uruchamiany i w wartości właściwości Progress zadania przepływu pracy. Gdy parametr PSProgressMessage jest również uwzględniony w poleceniu, zawartość paska postępu jest wyświetlana w <DisplayName>:<PSProgressMessage> formacie.

ErrorAction <ActionPreference>

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 ten z Write-Error polecenia cmdlet. Parametr ErrorAction zastępuje wartość $ErrorActionPreference zmiennej dla bieżącego polecenia. Ten parametr jest również typowym parametrem programu Windows PowerShell.

Prawidłowe wartości:

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

• Ignore. Pomija komunikat o błędzie i kontynuuje wykonywanie polecenia. W przeciwieństwie do SilentlyContinuezmiennej , Ignore nie dodaje komunikatu o błędzie do zmiennej automatycznej $Error . Wartość Ignore jest wprowadzana w programie Windows PowerShell 3.0.

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

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

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

• Stop. 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ść $False nie ma wpływu. Użyj tego parametru z słowami kluczowymi i równoległymi, ForEach -Parallel aby zbierać błędy i dane wyjściowe z wielu równoległych poleceń w jednej kolekcji.

PSActionRetryCount <Int32>

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

PSActionRetryIntervalSec <Int32>

Określa interwał między ponownymi próbami akcji w sekundach. Wartość domyślna , 0natychmiast ponawia próbę 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 z komputerami docelowymi. Wartość $False nie ma wpływu. Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

Jeśli używasz parametru PSConnectionURI , zdalne miejsce docelowe może zwrócić instrukcję, aby przekierować do innego identyfikatora URI. Domyślnie program Windows PowerShell nie przekierowuje połączeń, ale można użyć parametru PSAllowRedirection z wartością $True , aby zezwolić na przekierowywanie połączenia z komputerem docelowym.

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 SessionOption poleceń cmdlet, które tworzą sesję. Domyślna wartość 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, DigestCredSSPKerberos, , Negotiate, i NegotiateWithImplicitCredential. Domyślna wartość 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 zestawie SDK programu PowerShell.

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 programu Windows PowerShell Cert: .

PSComputerName <String[]>

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, localhostlub 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 z polecenia lub jest $null to wartość lub pusty ciąg, element docelowy przepływu pracy to 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 (a nie na komputerze z uruchomionym przepływem pracy). Wartość domyślna to Microsoft.PowerShell.Workflow. 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 4294 967 295 (UInt.MaxValue). Wartość domyślna, zero (0), reprezentuje 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>

Domyślna wartość to http://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 HTTPS. Aby użyć domyślnych portów komunikacji zdalnej programu Windows PowerShell, określ port 5985 protokołu HTTP lub 5986 HTTPS.

PSCredential PSCredential <>

Określa konto użytkownika, które ma uprawnienia do uruchamiania działania na komputerze docelowym. Wartość domyślna to użytkownik bieżący. 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 User01 lub Domain01\User01, lub wprowadź zmienną zawierającą obiekt PSCredential , taki jak zwracane przez Get-Credential polecenie 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 zapisywania komunikatów debugowania w konsoli lub 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 New-Object polecenia cmdlet , 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 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:

• (Ustawienie domyślne) W przypadku pominięcia i nie dodano również parametru PSDisableSerialization do działania, obiekty są 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[ErrorRecord]>

Dodaje komunikaty o błędach z działania do określonej kolekcji rekordów błędów zamiast zapisywania komunikatów o błędach w konsoli lub 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. Porty domyślne to 5985 (port Usługi WinRM dla protokołu HTTP) i 59'86 (port Usługi WinRM dla protokołu HTTPS). Ten wspólny parametr działania jest również typowym parametrem przepływu pracy.

Nie używaj parametru PSPort , chyba że musisz. 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 postępu z działania do określonej kolekcji rekordów postępu, zamiast zapisywać komunikaty postępu w konsoli lub do 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. Gdy element DisplayName jest również uwzględniony w poleceniu, zawartość paska postępu jest wyświetlana w <DisplayName>:<PSProgressMessage> formacie.

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:

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

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

• Custom: Działanie obsługuje własny typ komunikacji zdalnie. Ta wartość jest prawidłowa, gdy polecenie cmdlet 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 zainstalowane w ścieżce określonej w zmiennej środowiskowej PSModulePath są automatycznie importowane przy pierwszym użyciu dowolnego polecenia w module. Użyj tego parametru, aby zaimportować moduły, które nie znajdują się w lokalizacji PSModulePath .

Ponieważ każde działanie w przepływie pracy jest uruchamiane we własnej sesji, Import-Module polecenie importuje moduł tylko do sesji, w której jest uruchamiana. 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ą New-PSSessionOption polecenia cmdlet . 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 $PSSessionOption preferencji, zobacz about_Preference_Variables.

PSUseSSL <— wartość logiczna>

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

Usługa WS-Management szyfruje całą zawartość programu Windows PowerShell przesyłaną przez sieć. UseSSL to dodatkowa ochrona, która wysyła dane za pośrednictwem protokołu HTTPS zamiast protokołu 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 pisania pełnych komunikatów w konsoli lub wartości właściwości Pełne 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 ostrzegawczych, zamiast zapisywać komunikaty ostrzegawcze w konsoli programu lub wartość 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ń.

Result

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 w poniższym przykładowym przepływie pracy używa wspólnego parametru UseDefaultInput, Get-Process aby uzyskać dane wejściowe 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ść $VerbosePreference zmiennej 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.

WarningAction <ActionPreference>

Określa sposób reagowania działania na ostrzeżenie. Continue jest wartością domyślną. Parametr WarningAction zastępuje wartość $WarningPreference zmiennej 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:

• SilentlyContinue. Pomija komunikat ostrzegawczy i kontynuuje wykonywanie polecenia.

• Continue. Wyświetla komunikat ostrzegawczy i kontynuuje wykonywanie polecenia. Continue jest wartością domyślną.

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

• Stop. Wyświetla komunikat ostrzegawczy i zatrzymuje wykonywanie polecenia.

Uwaga

Parametr WarningAction nie zastępuje wartości $WarningAction zmiennej preferencji, gdy parametr jest używany w poleceniu do uruchamiania 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 podzestawie komputerów docelowych.

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

W poniższym przykładzie pokazano, jak używać typowych parametrów działania PSComputerName do uruchamiania Get-EventLog działania 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_Workflows
• about_WorkflowCommonParameters