about_ActivityCommonParameters

KORTE BESCHRIJVING

Beschrijft de parameters die Windows PowerShell Workflow toevoegt aan activiteiten.

LANGE BESCHRIJVING

Windows PowerShell Workflow voegt de algemene activiteitparameters toe aan activiteiten die zijn afgeleid van de psActivity-basisklasse . Deze categorie omvat de InlineScript-activiteit en Windows PowerShell-cmdlets die zijn geïmplementeerd als activiteiten, zoals Get-Process en Get-WinEvent.

De algemene parameters van de activiteit zijn ongeldig voor de Suspend-Workflow activiteiten en Checkpoint-Workflow ze worden niet toegevoegd aan cmdlets of expressies die windows PowerShell Workflow automatisch uitvoert in een InlineScript-scriptblok of soortgelijke activiteit. De algemene parameters van de activiteit zijn beschikbaar voor de InlineScript-activiteit , maar niet voor opdrachten in het InlineScript-scriptblok .

Een aantal algemene parameters van de activiteit zijn ook algemene parameters voor werkstromen of algemene Windows PowerShell-parameters. Andere algemene parameters voor activiteiten zijn uniek voor activiteiten.

Zie about_WorkflowCommonParameters voor meer informatie over de algemene parameters van de werkstroom. Zie about_CommonParameters voor meer informatie over de algemene windows PowerShell-parameters.

LIJST MET ALGEMENE PARAMETERS VAN ACTIVITEIT

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

PARAMETERBESCHRIJVINGEN

In deze sectie worden de algemene parameters van de activiteit beschreven.

AppendOutput <Booleaanse waarde>

Een waarde van $True voegt de uitvoer van de activiteit toe aan de waarde van de variabele. Een waarde van $False het type heeft geen effect. Standaard vervangt het toewijzen van een waarde aan een variabele de variabelewaarde.

Met de volgende opdrachten voegt u bijvoorbeeld een procesobject toe aan het serviceobject in de $x variabele.

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

Deze parameter is ontworpen voor op XAML gebaseerde werkstromen. In scriptwerkstromen kunt u ook de += toewijzingsoperator gebruiken om uitvoer toe te voegen aan de waarde van een variabele, zoals wordt weergegeven in het volgende voorbeeld.

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

Fouten opsporen in <SwitchParameter>

Geeft details op programmeurniveau weer over de bewerking die door de opdracht wordt uitgevoerd. De parameter Foutopsporing overschrijft de waarde van de $DebugPreference variabele voor de huidige opdracht. Deze parameter werkt alleen wanneer de opdracht foutopsporingsberichten genereert. Deze parameter is ook een algemene windows PowerShell-parameter.

DisplayName-tekenreeks <>

Hiermee geeft u een beschrijvende naam voor de activiteit. De waarde DisplayName wordt weergegeven op de voortgangsbalk terwijl de werkstroom wordt uitgevoerd en in de waarde van de eigenschap Voortgang van de werkstroomtaak. Wanneer de parameter PSProgressMessage ook is opgenomen in de opdracht, wordt de inhoud van de voortgangsbalk weergegeven in <DisplayName>:<PSProgressMessage> de indeling.

ErrorAction <ActionPreference>

Bepaalt hoe de activiteit reageert op een niet-afsluitfout van de opdracht. Dit heeft geen effect op beëindigingsfouten. Deze parameter werkt alleen wanneer de opdracht een niet-afsluitfout genereert, zoals die van de Write-Error cmdlet. De parameter ErrorAction overschrijft de waarde van de $ErrorActionPreference variabele voor de huidige opdracht. Deze parameter is ook een algemene windows PowerShell-parameter.

Geldige waarden:

• Continue. Geeft het foutbericht weer en gaat door met het uitvoeren van de opdracht. Continue is de standaardwaarde.

• Ignore. Onderdrukt het foutbericht en gaat door met het uitvoeren van de opdracht. In tegenstelling tot SilentlyContinue, Ignore voegt het foutbericht niet toe aan de $Error automatische variabele. De Ignore waarde wordt geïntroduceerd in Windows PowerShell 3.0.

• Inquire. Geeft het foutbericht weer en vraagt u om bevestiging voordat u doorgaat met de uitvoering. Deze waarde wordt zelden gebruikt.

• Suspend. Hiermee wordt een werkstroomtaak automatisch onderbroken om verder onderzoek mogelijk te maken. Na onderzoek kan de werkstroom worden hervat.

• SilentlyContinue. Onderdrukt het foutbericht en gaat door met het uitvoeren van de opdracht.

• Stop. Geeft het foutbericht weer en stopt met het uitvoeren van de opdracht.

Invoerobject <[]>

Hiermee verzendt u een verzameling objecten naar een activiteit. Dit is een alternatief voor pijpobjecten voor de activiteit één voor één.

MergeErrorToOutput <Boolean>

Een waarde voor het toevoegen van $True fouten aan de uitvoerstroom. Een waarde van $False het type heeft geen effect. Gebruik deze parameter met de trefwoorden Parallel en ForEach -Parallel trefwoorden om fouten en uitvoer van meerdere parallelle opdrachten in één verzameling te verzamelen.

PSActionRetryCount <Int32>

Probeert herhaaldelijk de activiteit uit te voeren als de eerste poging mislukt. De standaardwaarde, probeert 0het niet opnieuw.

PSActionRetryIntervalSec <Int32>

Bepaalt het interval tussen nieuwe pogingen in seconden. De standaardwaarde, 0voert de actie onmiddellijk opnieuw uit. Deze parameter is alleen geldig wanneer de parameter PSActionRetryCount ook wordt gebruikt in de opdracht.

PSActionRunningTimeoutSec <Int32>

Bepaalt hoe lang de activiteit op elke doelcomputer kan worden uitgevoerd. Als de activiteit niet is voltooid voordat de time-out verloopt, genereert Windows PowerShell Workflow een afsluitfout en stopt de verwerking van de werkstroom op de betreffende doelcomputer.

PSAllowRedirection <Booleaanse waarde>

Een waarde van het toestaan van $True omleiding van de verbinding met de doelcomputers. Een waarde van $False het type heeft geen effect. Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

Wanneer u de parameter PSConnectionURI gebruikt, kan de externe bestemming een instructie retourneren om om te leiden naar een andere URI. Windows PowerShell leidt standaard geen verbindingen om, maar u kunt de parameter PSAllowRedirection gebruiken met de waarde om $True omleiding van de verbinding met de doelcomputer toe te staan.

U kunt ook het aantal keren beperken dat de verbinding wordt omgeleid door de eigenschap MaximumConnectionRedirectionCount van de $PSSessionOption voorkeursvariabele in te stellen of de eigenschap MaximumConnectionRedirectionCount van de waarde van de parameter SessionOption van cmdlets die een sessie maken. De standaardwaarde is 5.

PSApplicationName-tekenreeks <>

Hiermee geeft u het toepassingsnaamsegment op van de verbindings-URI die wordt gebruikt om verbinding te maken met de doelcomputers. Gebruik deze parameter om de naam van de toepassing op te geven wanneer u de connectionURI-parameter niet gebruikt in de opdracht. Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

De standaardwaarde is de waarde van de $PSSessionApplicationName voorkeursvariabele op de doelcomputer. Als deze voorkeursvariabele niet is gedefinieerd, is de standaardwaarde WSMAN. Deze waarde is geschikt voor de meeste toepassingen. Zie about_Preference_Variables voor meer informatie.

De WinRM-service gebruikt de naam van de toepassing om een listener te selecteren voor de service van de verbindingsaanvraag. De waarde van deze parameter moet overeenkomen met de waarde van de eigenschap URLPrefix van een listener op de externe computer.

PSAuthentication <AuthenticationMechanism>

Hiermee geeft u het mechanisme op dat wordt gebruikt om de referenties van de gebruiker te verifiëren bij het maken van verbinding met de doelcomputers. Geldige waarden zijnDefault, , BasicCredSSP, Digest, , Kerberos, en NegotiateNegotiateWithImplicitCredential. De standaardwaarde is Default. Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

Zie de beschrijving van de opsomming System.Management.Automation.Runspaces.AuthenticationMechanism in de PowerShell SDK voor meer informatie over de waarden van deze parameter.

Waarschuwing

CredSSP-verificatie (Credential Security Service Provider), waarbij de referenties van de gebruiker worden doorgegeven aan een externe computer die moet worden geverifieerd, is ontworpen voor opdrachten waarvoor verificatie is vereist voor meer dan één resource, zoals toegang tot een externe netwerkshare. Dit mechanisme verhoogt het beveiligingsrisico van de externe bewerking. Als de externe computer is aangetast, kunnen de referenties die aan de computer worden doorgegeven, worden gebruikt om de netwerksessie te beheren.

PSCertificateThumbprint-tekenreeks <>

Hiermee geeft u het certificaat van de digitale openbare sleutel (X509) van een gebruikersaccount dat gemachtigd is om deze actie uit te voeren. Voer de vingerafdruk van het certificaat in. Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

Certificaten worden gebruikt in verificatie op basis van clientcertificaten. Ze kunnen alleen worden toegewezen aan lokale gebruikersaccounts; ze werken niet met domeinaccounts.

Als u een certificaat wilt ophalen, gebruikt u de cmdlets Get-Item of Get-ChildItem in het Windows PowerShell-station Cert: .

PSComputerName <String[]>

Hiermee geeft u de doelcomputers waarop de activiteit wordt uitgevoerd. Standaard is dit de lokale computer. Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

Typ de NETBIOS-naam, het IP-adres of de volledig gekwalificeerde domeinnaam van een of meer computers in een door komma's gescheiden lijst. Als u de lokale computer wilt opgeven, typt u de computernaam of localhosteen punt (.).

Als u de lokale computer wilt opnemen in de waarde van de parameter PSComputerName , opent u Windows PowerShell met de optie Als administrator uitvoeren .

Als deze parameter wordt weggelaten uit de opdracht, of deze waarde is $null of een lege tekenreeks, is het werkstroomdoel de lokale computer en wordt externe communicatie met Windows PowerShell niet gebruikt om de opdracht uit te voeren.

Als u een IP-adres wilt gebruiken in de waarde van de parameter ComputerName , moet de opdracht de PSCredential-parameter bevatten. De computer moet ook worden geconfigureerd voor HTTPS-transport of het IP-adres van de externe computer moet worden opgenomen in de winRM TrustedHosts-lijst op de lokale computer. Zie 'How to Add a Computer to the Trusted Host List' (Een computer toevoegen aan de lijst met vertrouwde hosts) in about_Remote_Troubleshooting voor instructies voor het toevoegen van een computernaam aan de lijst TrustedHosts.

PSConfigurationName-tekenreeks <>

Hiermee geeft u de sessieconfiguraties op die worden gebruikt voor het maken van sessies op de doelcomputers. Voer de naam in van een sessieconfiguratie op de doelcomputers (niet op de computer waarop de werkstroom wordt uitgevoerd). De standaardwaarde is Microsoft.PowerShell.Workflow. Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

PSConnectionRetryCount <UInt>

Hiermee geeft u het maximum aantal pogingen om verbinding te maken met elke doelcomputer als de eerste verbindingspoging mislukt. Voer een getal in tussen 1 en 4.294.967.295 (UInt.MaxValue). De standaardwaarde nul (0) vertegenwoordigt geen nieuwe pogingen. Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

PSConnectionRetryIntervalSec <UInt>

Hiermee geeft u de vertraging tussen pogingen voor opnieuw proberen in seconden. De standaardwaarde is nul (0). Deze parameter is alleen geldig wanneer de waarde van PSConnectionRetryCount ten minste 1 is. Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

PSConnectionURI <System.Uri>

Hiermee geeft u een URI (Uniform Resource Identifier) op die het verbindingseindpunt definieert voor de activiteit op de doelcomputer. De URI moet volledig gekwalificeerd zijn. Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

De notatie van deze tekenreeks is als volgt:

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

De standaardwaarde is http://localhost:5985/WSMAN.

Als u geen PSConnectionURI opgeeft, kunt u de parameters PSUseSSL, PSComputerName, PSPort en PSApplicationName gebruiken om de PSConnectionURI-waarden op te geven.

Geldige waarden voor het transportsegment van de URI zijn HTTP en HTTPS. Als u een verbindings-URI met een transportsegment opgeeft, maar geen poort opgeeft, wordt de sessie gemaakt met standaardenpoorten: 80 voor HTTP en 443 voor HTTPS. Als u de standaardpoorten voor externe communicatie met Windows PowerShell wilt gebruiken, geeft u de poort 5985 op voor HTTP of 5986 voor HTTPS.

PSCredential <PSCredential>

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om de activiteit uit te voeren op de doelcomputer. Standaard is dit de huidige gebruiker. Deze parameter is alleen geldig wanneer de parameter PSComputerName is opgenomen in de opdracht. Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een variabele in die een PSCredential-object bevat, zoals een variabele die door de Get-Credential cmdlet wordt geretourneerd. Als u alleen een gebruikersnaam invoert, wordt u om een wachtwoord gevraagd.

PSDebug <PSDataCollection[DebugRecord]>

Voegt foutopsporingsberichten van de activiteit toe aan de opgegeven verzameling foutopsporingsrecords, in plaats van de foutopsporingsberichten naar de console te schrijven of naar de waarde van de eigenschap Foutopsporing van de werkstroomtaak. U kunt foutopsporingsberichten van meerdere activiteiten toevoegen aan hetzelfde recordverzamelingsobject voor foutopsporing.

Als u deze activiteit algemene parameter wilt gebruiken, gebruikt u de New-Object cmdlet om een PSDataCollection-object te maken met een type DebugRecord en het object op te slaan in een variabele. Gebruik vervolgens de variabele als de waarde van de PSDebug-parameter van een of meer activiteiten, zoals wordt weergegeven in het volgende voorbeeld.

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") { ...}
}

PSDisableSerialization <Boolean>

Hiermee wordt de activiteit om 'live' (niet geserialiseerde) objecten naar de werkstroom te retourneren. De resulterende objecten hebben methoden, evenals eigenschappen, maar ze kunnen niet worden opgeslagen wanneer een controlepunt wordt genomen.

PSDisableSerializationPreference <Boolean>

Hiermee past u het equivalent van de parameter PSDisableSerialization toe op de gehele werkstroom, niet alleen op de activiteit. Het toevoegen van deze parameter wordt over het algemeen niet aanbevolen, omdat een werkstroom die de objecten niet serialiseert, niet kan worden hervat of behouden.

Geldige waarden:

• (Standaard) Als u dit weglaat en u de PSDisableSerialization-parameter ook niet hebt toegevoegd aan een activiteit, worden objecten geserialiseerd.

• $True. Hiermee worden alle activiteiten binnen een werkstroom om 'live' (niet geserialiseerde) objecten te retourneren. De resulterende objecten hebben methoden, evenals eigenschappen, maar ze kunnen niet worden opgeslagen wanneer een controlepunt wordt genomen.

• $False. Werkstroomobjecten worden geserialiseerd.

PSError <PSDataCollection[ErrorRecord]>

Voegt foutberichten van de activiteit toe aan de opgegeven verzameling foutrecords, in plaats van de foutberichten naar de console te schrijven of naar de waarde van de eigenschap Fout van de werkstroomtaak. U kunt foutberichten van meerdere activiteiten toevoegen aan hetzelfde object voor het verzamelen van foutenrecords.

Als u deze activiteit algemene parameter wilt gebruiken, gebruikt u de New-Object cmdlet om een PSDataCollection-object te maken met een type ErrorRecord en slaat u het object op in een variabele. Gebruik vervolgens de variabele als de waarde van de PSError-parameter van een of meer activiteiten, zoals wordt weergegeven in het volgende voorbeeld.

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 <Booleaanse waarde>

Neemt een controlepunt na de activiteit. Dit controlepunt is een aanvulling op alle controlepunten die zijn opgegeven in de werkstroom. Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

Een controlepunt of persistentiepunt is een momentopname van de werkstroomstatus en gegevens die worden vastgelegd terwijl de werkstroom wordt uitgevoerd en wordt opgeslagen in een persistentiearchief op schijf. Windows PowerShell Workflow gebruikt de opgeslagen gegevens om een onderbroken of onderbroken werkstroom te hervatten vanaf het laatste persistentiepunt in plaats van de werkstroom opnieuw op te starten.

Geldige waarden:

• (Standaard) Als u deze parameter weglaat, worden er geen controlepunten toegevoegd. Controlepunten worden genomen op basis van de instellingen voor de werkstroom.

• $True. Neemt een controlepunt nadat de activiteit is voltooid. Dit controlepunt is een aanvulling op alle controlepunten die zijn opgegeven in de werkstroom.

• $False. Er worden geen controlepunten toegevoegd. Controlepunten worden alleen gebruikt wanneer deze zijn opgegeven in de werkstroom.

PSPort <Int32>

Hiermee geeft u de netwerkpoort op de doelcomputers. De standaardpoorten zijn 5985 (de WinRM-poort voor HTTP) en 59'86 (de WinRM-poort voor HTTPS). Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

Gebruik de PSPort-parameter alleen als u dit moet doen. De poort die in de opdracht is ingesteld, is van toepassing op alle computers of sessies waarop de opdracht wordt uitgevoerd. Een alternatieve poortinstelling kan verhinderen dat de opdracht wordt uitgevoerd op alle computers. Voordat u een alternatieve poort gebruikt, moet u de WinRM-listener op de externe computer configureren om naar die poort te luisteren.

PSProgress <PSDataCollection[ProgressRecord]>

Hiermee voegt u voortgangsberichten van de activiteit toe aan de opgegeven verzameling voortgangsrecords, in plaats van de voortgangsberichten naar de console te schrijven of naar de waarde van de eigenschap Voortgang van de werkstroomtaak. U kunt voortgangsberichten van meerdere activiteiten toevoegen aan hetzelfde object voor het verzamelen van voortgangsrecords.

PSProgressMessage-tekenreeks <>

Hiermee geeft u een beschrijvende beschrijving van de activiteit. De psProgressMessage-waarde wordt weergegeven op de voortgangsbalk terwijl de werkstroom wordt uitgevoerd. Wanneer de DisplayName ook is opgenomen in de opdracht, wordt de inhoud van de voortgangsbalk weergegeven in <DisplayName>:<PSProgressMessage> de indeling.

Deze parameter is met name handig voor het identificeren van activiteiten in een ForEach -Parallel scriptblok. Zonder dit bericht worden activiteiten in alle parallelle vertakkingen geïdentificeerd met dezelfde naam.

PSRemotingBehavior <RemotingBehavior>

Hiermee geeft u op hoe externe communicatie wordt beheerd wanneer de activiteit wordt uitgevoerd op doelcomputers. PowerShell is de standaardinstelling.

Geldige waarden zijn:

• None: De activiteit wordt niet uitgevoerd op externe computers.

• PowerShell: externe communicatie van Windows PowerShell wordt gebruikt om de activiteit uit te voeren op doelcomputers.

• Custom: De activiteit ondersteunt zijn eigen type externe communicatie. Deze waarde is geldig wanneer de cmdlet die wordt geïmplementeerd als een activiteit de waarde van het kenmerk RemotingCapability instelt op SupportedByCommand en de opdracht de parameter ComputerName bevat.

PSRequiredModules <String[]>

Hiermee importeert u de opgegeven modules voordat u de opdracht uitvoert. Voer de modulenamen in. De modules moeten op de doelcomputer worden geïnstalleerd.

Modules die zijn geïnstalleerd in een pad dat is opgegeven in de omgevingsvariabele PSModulePath , worden automatisch geïmporteerd bij het eerste gebruik van een opdracht in de module. Gebruik deze parameter om modules te importeren die zich niet in een PSModulePath-locatie bevinden.

Omdat elke activiteit in een werkstroom in een eigen sessie wordt uitgevoerd, importeert een Import-Module opdracht alleen een module in de sessie waarin deze wordt uitgevoerd. De module wordt niet geïmporteerd in sessies waarin andere activiteiten worden uitgevoerd.

PSSessionOption <PSSessionOption>

Hiermee stelt u geavanceerde opties voor de sessies in op de doelcomputers. Voer een PSSessionOption-object in, zoals een object dat u maakt met behulp van de New-PSSessionOption cmdlet. Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

De standaardwaarden voor de sessieopties worden bepaald door de waarde van de $PSSessionOption voorkeursvariabele, als deze is ingesteld. Anders gebruikt de sessie de waarden die zijn opgegeven in de sessieconfiguratie.

Zie het Help-onderwerp voor de cmdlet New-PSSessionOption New-PSSessionOption voor een beschrijving van de sessieopties, inclusief de standaardwaarden.

Zie about_Preference_Variables voor meer informatie over de $PSSessionOption voorkeursvariabele.

PSUseSSL <Booleaanse waarde>

Een waarde van het ssl-protocol (Secure Sockets Layer) voor het tot stand brengen van $True een verbinding met de doelcomputer. Standaard wordt SSL niet gebruikt. Een waarde van $False het type heeft geen effect. Deze algemene parameter voor activiteit is ook een gemeenschappelijke werkstroomparameter.

WS-Management versleutelt alle Windows PowerShell-inhoud die via het netwerk wordt verzonden. UseSSL is een extra beveiliging waarmee de gegevens via een HTTPS worden verzonden in plaats van HTTP. Als u deze parameter gebruikt, maar SSL niet beschikbaar is op de poort die voor de opdracht wordt gebruikt, mislukt de opdracht.

PSVerbose <PSDataCollection[VerboseRecord]>

Voegt uitgebreide berichten van de activiteit toe aan de opgegeven uitgebreide recordverzameling, in plaats van de uitgebreide berichten naar de console te schrijven of aan de waarde van de uitgebreide eigenschap van de werkstroomtaak. U kunt uitgebreide berichten van meerdere activiteiten toevoegen aan hetzelfde uitgebreide recordverzamelingsobject.

PSWarning <PSDataCollection[WarningRecord]>

Hiermee voegt u waarschuwingsberichten van de activiteit toe aan de opgegeven verzameling waarschuwingsrecords in plaats van de waarschuwingsberichten naar de console te schrijven of naar de waarde van de eigenschap Waarschuwing van de werkstroomtaak. U kunt waarschuwingsberichten van meerdere activiteiten toevoegen aan hetzelfde object voor het verzamelen van waarschuwingsrecords.

Resultaat

Deze parameter is alleen geldig in XAML-werkstromen.

UseDefaultInput <Boolean>

Accepteert alle werkstroominvoer als invoer voor de activiteit op waarde.

Voor de Get-Process activiteit in de volgende voorbeeldwerkstroom wordt bijvoorbeeld de algemene parameter UseDefaultInput-activiteit gebruikt om invoer op te halen die wordt doorgegeven aan de werkstroom. Wanneer u de werkstroom uitvoert met invoer, wordt die invoer gebruikt door de activiteit.

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

<Uitgebreide SwitchParameter>

Geeft gedetailleerde informatie weer over de bewerking die door de opdracht wordt uitgevoerd. Deze informatie lijkt op de informatie in een tracering of in een transactielogboek. De uitgebreide parameter overschrijft de waarde van de $VerbosePreference variabele voor de huidige opdracht. Deze parameter werkt alleen wanneer de opdracht een uitgebreid bericht genereert. Deze parameter is ook een algemene windows PowerShell-parameter.

WarningAction <ActionPreference>

Bepaalt hoe de activiteit reageert op een waarschuwing. Continue is de standaardwaarde. De parameter WarningAction overschrijft de waarde van de $WarningPreference variabele voor de huidige opdracht. Deze parameter werkt alleen wanneer de opdracht een waarschuwingsbericht genereert. Deze parameter is ook een algemene windows PowerShell-parameter.

Geldige waarden:

• SilentlyContinue. Onderdrukt het waarschuwingsbericht en gaat door met het uitvoeren van de opdracht.

• Continue. Geeft het waarschuwingsbericht weer en gaat door met het uitvoeren van de opdracht. Continue is de standaardwaarde.

• Inquire. Geeft het waarschuwingsbericht weer en vraagt u om bevestiging voordat u doorgaat met de uitvoering. Deze waarde wordt zelden gebruikt.

• Stop. Geeft het waarschuwingsbericht weer en stopt met het uitvoeren van de opdracht.

Notitie

De parameter WarningAction overschrijft de waarde van de $WarningAction voorkeursvariabele niet wanneer de parameter wordt gebruikt in een opdracht om een script of functie uit te voeren.

VOORBEELDEN

De algemene parameters van de activiteit zijn zeer nuttig. U kunt bijvoorbeeld de parameter PSComputerName gebruiken om bepaalde activiteiten uit te voeren op slechts een subset van de doelcomputers.

U kunt ook de parameters PSConnectionRetryCount en PSConnectionRetryIntervalSec gebruiken om de waarden voor nieuwe pogingen voor bepaalde activiteiten aan te passen.

In het volgende voorbeeld ziet u hoe u de algemene parameters van de PSComputerName-activiteit gebruikt om alleen een Get-EventLog activiteit uit te voeren op computers waarop het een bepaald domein is.

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

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

Zie ook

• about_Workflows
• about_WorkflowCommonParameters