Grafisch ontwerpen in Azure AutomationGraphical authoring in Azure Automation

Grafisch ontwerpen kunt u runbooks voor Azure Automation maken zonder de complexiteit van de onderliggende code van de Windows PowerShell of PowerShell-werkstroom.Graphical Authoring allows you to create runbooks for Azure Automation without the complexities of the underlying Windows PowerShell or PowerShell Workflow code. U activiteiten toevoegen aan het canvas uit een bibliotheek met cmdlets en runbooks, ze aan elkaar koppelen en configureren om een werkstroom.You add activities to the canvas from a library of cmdlets and runbooks, link them together and configure to form a workflow. Als u ooit met System Center Orchestrator of Service Management Automation (SMA) hebt gewerkt, klikt u vervolgens ziet dit er waarschijnlijk vertrouwd voor uIf you have ever worked with System Center Orchestrator or Service Management Automation (SMA), then this should look familiar to you

Dit artikel bevat een inleiding tot het grafisch ontwerpen en de concepten die u nodig hebt om te beginnen bij het maken van een grafisch runbook.This article provides an introduction to graphical authoring and the concepts you need to get started in creating a graphical runbook.

Grafische runbooksGraphical runbooks

Alle runbooks in Azure Automation zijn Windows PowerShell-werkstromen.All runbooks in Azure Automation are Windows PowerShell Workflows. Grafisch en grafische PowerShell Workflow-runbooks PowerShell-code die wordt uitgevoerd door de werknemers Automation genereren, maar u bent niet kunnen worden weergegeven of rechtstreeks wijzigen.Graphical and Graphical PowerShell Workflow runbooks generate PowerShell code that is run by the Automation workers, but you are not able to view it or directly modify it. Een grafisch runbook kan worden geconverteerd naar een grafische PowerShell Workflow-runbook en vice versa, maar ze kunnen niet worden geconverteerd naar een tekstuele runbook.A Graphical runbook can be converted to a Graphical PowerShell Workflow runbook and vice-versa, but they cannot be converted to a textual runbook. Een bestaand tekstuele runbook kan niet worden geïmporteerd in de grafische editor.An existing textual runbook cannot be imported into the graphical editor.

Overzicht van de grafische editorOverview of graphical editor

U kunt de grafische editor in Azure portal openen door te maken of bewerken van een grafisch runbook.You can open the graphical editor in the Azure portal by creating or editing a graphical runbook.

Grafische werkruimte

De volgende secties beschrijven de besturingselementen in de grafische editor.The following sections describe the controls in the graphical editor.

CanvasCanvas

Het Canvas is waar u uw runbook te ontwerpen.The Canvas is where you design your runbook. U activiteiten van de knooppunten in het besturingselement bibliotheek toevoegen aan het runbook en verbind deze met koppelingen voor het definiëren van de logica van het runbook.You add activities from the nodes in the Library control to the runbook and connect them with links to define the logic of the runbook.

U kunt de besturingselementen aan de onderkant van het canvas in-en uitzoomen.You can use the controls at the bottom of the canvas to zoom in and out.

Besturingselement bibliotheekLibrary control

Het besturingselement bibliotheek is waar u het selecteert activiteiten om toe te voegen aan uw runbook.The Library control is where you select activities to add to your runbook. U toevoegen ze aan het papier waar u deze aan andere activiteiten verbinden.You add them to the canvas where you connect them to other activities. Het bevat vier secties wordt beschreven in de volgende tabel:It includes four sections described in the following table:

SectieSection BeschrijvingDescription
CmdletsCmdlets Bevat alle cmdlets die kunnen worden gebruikt in uw runbook.Includes all the cmdlets that can be used in your runbook. Cmdlets zijn ingedeeld door de module.Cmdlets are organized by module. Alle modules die u hebt geïnstalleerd in uw automation-account zijn beschikbaar.All of the modules that you have installed in your automation account are available.
RunbooksRunbooks Bevat de runbooks in uw automation-account.Includes the runbooks in your automation account. Deze runbooks kunnen worden toegevoegd aan het canvas om te worden gebruikt als onderliggende runbooks.These runbooks can be added to the canvas to be used as child runbooks. Alleen runbooks van hetzelfde type als het runbook wordt bewerkt core worden weergegeven; Grafische worden runbooks alleen op PowerShell gebaseerde runbooks weergegeven, terwijl voor grafische PowerShell Workflow-runbooks alleen PowerShell-werkstroom runbooks worden weergegeven.Only runbooks of the same core type as the runbook being edited are shown; for Graphical runbooks only PowerShell-based runbooks are shown, while for Graphical PowerShell Workflow runbooks only PowerShell-Workflow-based runbooks are shown.
AssetsAssets Bevat de automation-assets in uw automation-account die kan worden gebruikt in uw runbook.Includes the automation assets in your automation account that can be used in your runbook. Wanneer u een asset aan een runbook toevoegt, wordt een workflow-activiteit die de geselecteerde asset wordt toegevoegd.When you add an asset to a runbook, it adds a workflow activity that gets the selected asset. In het geval van een variabele assets, kunt u selecteren of toevoegen van een activiteit als u wilt ophalen van de variabele of stelt u de variabele.In the case of variable assets, you can select whether to add an activity to get the variable or set the variable.
RunbookbesturingRunbook Control Runbook-controleactiviteiten die kunnen worden gebruikt bevat in uw huidige runbook.Includes runbook control activities that can be used in your current runbook. Een koppelingspunten neemt van meerdere invoergegevens en wacht totdat alle hebt voltooid voordat de werkstroom.A Junction takes multiple inputs and waits until all have completed before continuing the workflow. Een Code activiteit wordt uitgevoerd voor een of meer regels met code van PowerShell of PowerShell-werkstroom, afhankelijk van het type grafisch runbook.A Code activity runs one or more lines of PowerShell or PowerShell Workflow code depending on the graphical runbook type. U kunt deze activiteit gebruiken voor aangepaste code of functionaliteit die moeilijk te bereiken met andere activiteiten.You can use this activity for custom code or for functionality that is difficult to achieve with other activities.

ConfiguratiebeheerConfiguration control

De configuratie-besturingselement is waar u details opgeven voor een object dat is geselecteerd op het canvas.The Configuration control is where you provide details for an object selected on the canvas. De eigenschappen die beschikbaar zijn in dit besturingselement is afhankelijk van het type object dat is geselecteerd.The properties available in this control depends on the type of object selected. Wanneer u een optie in het configuratie-besturingselement selecteert, wordt extra blades geopend zodat u meer informatie.When you select an option in the Configuration control, it opens additional blades in order to provide additional information.

Besturingselement testenTest control

Het besturingselement van de Test wordt niet weergegeven wanneer de grafische editor voor het eerst wordt gestart.The Test control is not displayed when the graphical editor is first started. Deze wordt geopend wanneer u interactief testen van een grafisch runbook.It is opened when you interactively test a graphical runbook.

Grafisch runbook proceduresGraphical runbook procedures

Exporteren en importeren van een grafisch runbookExporting and importing a graphical runbook

U kunt alleen de gepubliceerde versie van een grafisch runbook exporteren.You can only export the published version of a graphical runbook. Als het runbook is nog niet gepubliceerd, dan zal de exporteren knop is uitgeschakeld.If the runbook has not yet been published, then the Export button is disabled. Wanneer u klikt op de exporteren knop, het runbook wordt gedownload naar uw lokale computer.When you click the Export button, the runbook is downloaded to your local computer. De naam van het bestand overeenkomt met de naam van het runbook met een graphrunbook extensie.The name of the file matches the name of the runbook with a graphrunbook extension.

U kunt een grafisch of grafische PowerShell Workflow-runbook-bestand importeren met het selecteren van de importeren optie bij het toevoegen van een runbook.You can import a Graphical or Graphical PowerShell Workflow runbook file by selecting the Import option when adding a runbook. Wanneer u het te importeren bestand selecteert, kunt u dezelfde bewaren naam of geef een nieuwe.When you select the file to import, you can keep the same Name or provide a new one. Het veld Type van Runbook wordt het type van runbook weergegeven nadat deze het geselecteerde bestand beoordeelt en als u probeert om te selecteren van een ander type dan niet juist is, een bericht wordt weergegeven waarbij er mogelijke conflicten en tijdens de conversie, kunnen er syntaxis Er zijn fouten.The Runbook Type field will display the type of runbook after it assesses the file selected and if you attempt to select a different type that is not correct, a message will be presented noting there are potential conflicts and during conversion, there could be syntax errors.

Runbook importeren

Een grafisch runbook testenTesting a graphical runbook

Terwijl u de gepubliceerde versie van het runbook ongewijzigd, of u een nieuw runbook testen kunt voordat deze is gepubliceerd, kunt u de conceptversie van een runbook testen in Azure portal.You can test the Draft version of a runbook in the Azure portal while leaving the published version of the runbook unchanged, or you can test a new runbook before it has been published. Hiermee kunt u controleren of het runbook correct werkt voordat u de gepubliceerde versie vervangen.This allows you to verify that the runbook is working correctly before replacing the published version. Wanneer u een runbook test, wordt het concept runbook wordt uitgevoerd en de acties die worden uitgevoerd worden voltooid.When you test a runbook, the Draft runbook is executed and any actions that it performs are completed. Er wordt geen Taakgeschiedenis wordt gemaakt, maar uitvoer wordt weergegeven in het deelvenster Testuitvoer.No job history is created, but output is displayed in the Test Output Pane.

Open het Test-besturingselement voor een runbook door het openen van het runbook om te bewerken en klik vervolgens op de testvenster knop.Open the Test control for a runbook by opening the runbook for edit and then click on the Test pane button.

Het besturingselement van de Test wordt gevraagd voor alle invoerparameters en u het runbook start door te klikken op de Start knop.The Test control prompts for any input parameters, and you can start the runbook by clicking on the Start button.

Een grafisch runbook publicerenPublishing a graphical runbook

Elk runbook in Azure Automation heeft een ontwerpversie en een gepubliceerde versie.Each runbook in Azure Automation has a Draft and a Published version. Alleen de gepubliceerde versie is beschikbaar om te worden uitgevoerd, en alleen de conceptversie kan worden bewerkt.Only the Published version is available to be run, and only the Draft version can be edited. De gepubliceerde versie wordt niet beïnvloed door wijzigingen in de conceptversie.The Published version is unaffected by any changes to the Draft version. Wanneer de conceptversie nu is beschikbaar is, publiceert u deze, die wordt de gepubliceerde versie door de conceptversie overschreven.When the Draft version is ready to be available, then you publish it, which overwrites the Published version with the Draft version.

U kunt een grafisch runbook publiceren door het openen van het runbook voor het bewerken en vervolgens te klikken op de publiceren knop.You can publish a graphical runbook by opening the runbook for editing and then clicking on the Publish button.

Wanneer een runbook is nog niet gepubliceerd, heeft de status van nieuw.When a runbook has not yet been published, it has a status of New. Wanneer het wordt gepubliceerd, heeft deze een status gepubliceerd.When it is published, it has a status of Published. Als u het runbook bewerken nadat deze is gepubliceerd, en de conceptversie en een gepubliceerde versies verschillend zijn, heeft het runbook de status van bewerken.If you edit the runbook after it has been published, and the Draft and Published versions are different, the runbook has a status of In edit.

Runbook-statussen

U hebt ook de mogelijkheid om terug te keren naar de gepubliceerde versie van een runbook.You also have the option to revert to the Published version of a runbook. Dit verwijdert u alle wijzigingen omdat het runbook het laatst is gepubliceerd en de conceptversie van het runbook door de gepubliceerde versie vervangt.This throws away any changes made since the runbook was last published and replaces the Draft version of the runbook with the Published version.

ActiviteitenActivities

Activiteiten zijn de bouwstenen van een runbook.Activities are the building blocks of a runbook. Een activiteit kan bestaan uit een PowerShell-cmdlet, een onderliggend runbook of een workflow-activiteit.An activity can be a PowerShell cmdlet, a child runbook, or a workflow activity. Toevoegen van een activiteit aan het runbook door te selecteren met de rechtermuisknop op in het besturingselement bibliotheek toevoegen aan papier.You add an activity to the runbook by right-clicking it in the Library control and selecting Add to canvas. U kunt Klik en sleep de activiteit overal op het canvas dat u wilt plaatsen.You can then click and drag the activity to place it anywhere on the canvas that you like. De locatie van de activiteit op het canvas heeft geen invloed op de werking van het runbook op geen enkele manier.The location of the activity on the canvas does not affect the operation of the runbook in any way. U kunt indelen uw runbook echter vindt u het meest geschikt is voor het visualiseren van de werking ervan.You can lay out your runbook however you find it most suitable to visualize its operation.

Toevoegen aan papier

Selecteer de activiteit op het canvas voor het configureren van de eigenschappen en parameters in de blade van de configuratie.Select the activity on the canvas to configure its properties and parameters in the Configuration blade. U kunt wijzigen de Label van de activiteit in op iets dat beschrijvende aan u is.You can change the Label of the activity to something that is descriptive to you. De oorspronkelijke cmdlet nog steeds wordt uitgevoerd, wijzigt u gewoon de weergavenaam die wordt gebruikt in de grafische editor.The original cmdlet is still being run, you are simply changing its display name that is used in the graphical editor. Het label moet uniek zijn binnen het runbook.The label must be unique within the runbook.

ParametersetsParameter sets

Een parameterset definieert de verplichte en optionele parameters die waarden voor een bepaalde cmdlet te accepteren.A parameter set defines the mandatory and optional parameters that accept values for a particular cmdlet. Alle cmdlets hebben ten minste één parameter is ingesteld, en soms meerdere.All cmdlets have at least one parameter set, and some have multiple. Als een cmdlet meerdere parametersets bevat, moet klikt u vervolgens u selecteren welke methode u gebruikt voordat u parameters kunt configureren.If a cmdlet has multiple parameter sets, then you must select which one you use before you can configure parameters. De parameters die u kunt configureren, is afhankelijk van de parameter is ingesteld dat u kiest.The parameters that you can configure depends on the parameter set that you choose. Kunt u de parameterset gebruikt door een activiteit door het selecteren van parameterset en een andere verzameling te selecteren.You can change the parameter set used by an activity by selecting Parameter Set and selecting another set. In dit geval gaan alle parameterwaarden die u hebt geconfigureerd verloren.In this case, any parameter values that you configured are lost.

In het volgende voorbeeld bevat de cmdlet Get-AzureRmVM drie parametersets.In the following example, the Get-AzureRmVM cmdlet has three parameter sets. U kunt parameterwaarden niet configureren, totdat u een van de parametersets selecteren.You cannot configure parameter values until you select one of the parameter sets. De parameterset ListVirtualMachineInResourceGroupParamSet is voor het retourneren van alle virtuele machines in een resourcegroep en heeft één optionele parameter.The ListVirtualMachineInResourceGroupParamSet parameter set is for returning all virtual machines in a resource group and has a single optional parameter. De GetVirtualMachineInResourceGroupParamSet is voor het opgeven van de virtuele machine dat u wilt retourneren en heeft twee verplicht en een optionele parameter.The GetVirtualMachineInResourceGroupParamSet is for specifying the virtual machine you want to return and has two mandatory and one optional parameter.

Parameterset

ParameterwaardenParameter values

Als u een waarde voor een parameter opgeeft, selecteert u een gegevensbron om te bepalen hoe de waarde is opgegeven.When you specify a value for a parameter, you select a data source to determine how the value is specified. De gegevensbronnen die beschikbaar zijn voor een bepaalde parameter, is afhankelijk van de geldige waarden voor deze parameter.The data sources that are available for a particular parameter depends on the valid values for that parameter. Bijvoorbeeld: Null is niet een beschikbare optie voor een parameter die null-waarden zijn niet toegestaan.For example, Null is not an available option for a parameter that does not allow null values.

GegevensbronData Source BeschrijvingDescription
Constante waardeConstant Value Typ een waarde voor de parameter.Type in a value for the parameter. Dit is alleen beschikbaar voor de volgende gegevenstypen: Int32, Int64, tekenreeks, Boole-waarde, DateTime, Switch.This is only available for the following data types: Int32, Int64, String,Boolean,DateTime,Switch.
Uitvoer van activiteitActivity Output De uitvoer van een activiteit die voorafgaat aan de huidige activiteit in de werkstroom.Output from an activity that precedes the current activity in the workflow. Alle geldige activiteiten worden weergegeven.All valid activities are listed. Selecteer alleen de activiteit met de uitvoer voor de waarde van parameter.Select just the activity to use its output for the parameter value. Als de uitvoer van de activiteit een object met meerdere eigenschappen, kunt u opgeven de naam van de eigenschap na het selecteren van de activiteit.If the activity outputs an object with multiple properties, then you can type in the name of the property after selecting the activity.
RunbookinvoerRunbook Input Selecteer een runbook-invoerparameter als invoer voor de parameter van de activiteit.Select a runbook input parameter as input to the activity parameter.
VariabeleassetVariable Asset Selecteer een Automation-variabele als invoer.Select an Automation Variable as input.
Referentie-elementCredential Asset Selecteer een Automation-referentie als invoer.Select an Automation Credential as input.
CertificaatassetCertificate Asset Selecteer een Automation-certificaat als invoer.Select an Automation Certificate as input.
VerbindingsassetConnection Asset Selecteer een Automation-verbinding als invoer.Select an Automation Connection as input.
PowerShell-expressiePowerShell Expression Geef een eenvoudige PowerShell-expressie.Specify simple PowerShell expression. De expressie wordt geëvalueerd vóór de activiteit en het resultaat dat wordt gebruikt voor de parameterwaarde.The expression is evaluated before the activity and the result used for the parameter value. U kunt variabelen gebruiken om te verwijzen naar de uitvoer van een activiteit of een runbook-invoerparameter.You can use variables to refer to the output of an activity or a runbook input parameter.
Niet geconfigureerdNot configured Hiermee schakelt u elke waarde die eerder was geconfigureerd.Clears any value that was previously configured.

Optionele extra parametersOptional additional parameters

Alle cmdlets hebben de optie voor het bieden van aanvullende parameters.All cmdlets have the option to provide additional parameters. Dit zijn algemene PowerShell-parameters of andere aangepaste parameters.These are PowerShell common parameters or other custom parameters. Krijgt u een tekstvak waarin u de parameters met behulp van PowerShell-syntaxis kunt opgeven.You are presented with a text box where you can provide parameters using PowerShell syntax. Bijvoorbeeld, om te gebruiken de uitgebreid algemene parameter geeft u '-Verbose: $True ".For example, to use the Verbose common parameter, you would specify "-Verbose:$True".

Opnieuw proberen van activiteitRetry activity

Gedrag voor opnieuw proberen kunt u een activiteit meerdere keren worden uitgevoerd tot aan een bepaalde voorwaarde wordt voldaan, net als een lus.Retry Behavior allows an activity to be run multiple times until a particular condition is met, much like a loop. U kunt deze functie gebruiken voor activiteiten die meerdere keren moet worden uitgevoerd, is dit foutgevoelig zijn, en mogelijk moet meer dan één poging voor het slagen of testen van de informatie over de uitvoer van de activiteit voor geldige gegevens.You can use this feature for activities that should run multiple times, are error prone, and may need more than one attempt for success, or test the output information of the activity for valid data.

Wanneer u opnieuw proberen voor een activiteit inschakelt, kunt u een vertraging en een voorwaarde instellen.When you enable retry for an activity, you can set a delay and a condition. De vertraging is de tijd (gemeten in seconden of minuten) dat het runbook wacht voordat deze de activiteit opnieuw wordt uitgevoerd.The delay is the time (measured in seconds or minutes) that the runbook waits before it runs the activity again. Als er geen vertraging is opgegeven, worden klikt u vervolgens de activiteit opnieuw uitgevoerd onmiddellijk nadat deze is voltooid.If no delay is specified, then the activity will run again immediately after it completes.

Poging van de activiteit

De voorwaarde voor opnieuw proberen is een PowerShell-expressie die wordt geëvalueerd na elke keer dat de activiteit wordt uitgevoerd.The retry condition is a PowerShell expression that is evaluated after each time the activity runs. Als de expressie op ' True ' is opgelost, klikt u vervolgens de activiteit opnieuw uitgevoerd.If the expression resolves to True, then the activity runs again. De expressie wordt omgezet naar ONWAAR, wordt de activiteit niet opnieuw uitgevoerd als het runbook gaat verder met de volgende activiteit.If the expression resolves to False, then the activity does not run again, and the runbook moves on to the next activity.

Poging van de activiteit

De voorwaarde opnieuw kunt gebruiken een variabele met de naam $RetryData die toegang tot informatie over de activiteit nieuwe pogingen biedt.The retry condition can use a variable called $RetryData that provides access to information about the activity retries. Deze variabele heeft de eigenschappen in de volgende tabel:This variable has the properties in the following table:

EigenschapProperty BeschrijvingDescription
NumberOfAttemptsNumberOfAttempts Het aantal keren dat de activiteit is uitgevoerd.Number of times that the activity has been run.
UitvoerOutput De uitvoer van de laatste uitvoering van de activiteit.Output from the last run of the activity.
TotalDurationTotalDuration Time-out verstreken sinds de eerste keer door de activiteit is gestart.Timed elapsed since the activity was started the first time.
StartedAtStartedAt Tijd in UTC-notatie die de activiteit voor het eerst is gestart.Time in UTC format the activity was first started.

Hieronder vindt u voorbeelden van de activiteit van de voorwaarden opnieuw.Following are examples of activity retry conditions.

# Run the activity exactly 10 times.
$RetryData.NumberOfAttempts -ge 10
# Run the activity repeatedly until it produces any output.
$RetryData.Output.Count -ge 1
# Run the activity repeatedly until 2 minutes has elapsed.
$RetryData.TotalDuration.TotalMinutes -ge 2

Nadat u een voorwaarde voor opnieuw proberen voor een activiteit hebt geconfigureerd, bevat de activiteit twee visuele aanwijzingen om u te herinneren.After you configure a retry condition for an activity, the activity includes two visual cues to remind you. Een wordt weergegeven in de activiteit en de andere is bij het controleren van de configuratie van de activiteit.One is presented in the activity and the other is when you review the configuration of the activity.

Activiteit opnieuw proberen Visual indicatoren

Script werkstroombeheerWorkflow Script control

Een Code-besturingselement is een speciale activiteit PowerShell of PowerShell-werkstroom script afhankelijk van het type grafisch runbook wordt geschreven accepteert zodat de functionaliteit die anders mogelijk niet beschikbaar.A Code control is a special activity that accepts PowerShell or PowerShell Workflow script depending on the type of graphical runbook being authored in order to provide functionality that may otherwise not be available. Er kan geen parameters accepteren, maar deze variabelen kunt gebruiken voor activiteit uitvoer en runbook-invoerparameters.It cannot accept parameters, but it can use variables for activity output and runbook input parameters. Uitvoer van de activiteit is toegevoegd aan de gegevensbus, tenzij er geen uitgaande koppelen in dat geval wordt deze toegevoegd aan de uitvoer van het runbook.Any output of the activity is added to the databus unless it has no outgoing link in which case it is added to the output of the runbook.

Bijvoorbeeld, berekeningen de volgende code datum met behulp van een runbook invoer variabele $NumberOfDays genoemd.For example, the following code performs date calculations using a runbook input variable called $NumberOfDays. Vervolgens stuurt een berekende tijd als uitvoer moet worden gebruikt door volgende activiteiten in het runbook.It then sends a calculated date time as output to be used by subsequent activities in the runbook.

$DateTimeNow = (Get-Date).ToUniversalTime()
$DateTimeStart = ($DateTimeNow).AddDays(-$NumberOfDays)}
$DateTimeStart

Een koppeling verbinding maakt twee activiteiten in een grafisch runbook.A link in a graphical runbook connects two activities. Als een pijl van de bronactiviteit naar de doelactiviteit wordt dit weergegeven op het canvas.It is displayed on the canvas as an arrow pointing from the source activity to the destination activity. De activiteiten worden uitgevoerd in de richting van de pijl met de doelactiviteit starten nadat de bronactiviteit is voltooid.The activities run in the direction of the arrow with the destination activity starting after the source activity completes.

Maak een koppeling tussen twee activiteiten op basis van de bronactiviteit selecteren en te klikken op de cirkel aan de onderkant van de vorm.Create a link between two activities by selecting the source activity and clicking the circle at the bottom of the shape. Sleep de pijl naar de doelactiviteit en release.Drag the arrow to the destination activity and release.

Een koppeling maken

Selecteer de koppeling naar de eigenschappen ervan configureren in de blade van de configuratie.Select the link to configure its properties in the Configuration blade. Dit omvat het koppelingstype, die wordt beschreven in de volgende tabel:This includes the link type, which is described in the following table:

Type koppelingLink Type BeschrijvingDescription
PijplijnPipeline De doelactiviteit wordt eenmaal uitgevoerd voor elk objectuitvoer van de bronactiviteit.The destination activity is run once for each object output from the source activity. De doelactiviteit wordt niet uitgevoerd als de bronactiviteit in geen uitvoer resulteert.The destination activity does not run if the source activity results in no output. Uitvoer van de bronactiviteit is beschikbaar als een object.Output from the source activity is available as an object.
VolgordeSequence De doelactiviteit wordt slechts één keer uitgevoerd.The destination activity runs only once. Ontvangt deze een matrix met objecten uit de bronactiviteit.It receives an array of objects from the source activity. Uitvoer van de bronactiviteit is beschikbaar als een matrix met objecten.Output from the source activity is available as an array of objects.

Activiteit vanafStarting activity

Een grafisch runbook begint met alle activiteiten die nog geen een binnenkomende verbinding.A graphical runbook starts with any activities that do not have an incoming link. Dit is vaak slechts één activiteit, die als de eerste activiteit voor het runbook fungeren kan.This is often only one activity, which would act as the starting activity for the runbook. Als meerdere activiteiten nog geen koppeling van een binnenkomende, vervolgens het runbook wordt gestart door kunnen parallel worden uitgevoerd.If multiple activities do not have an incoming link, then the runbook starts by running them in parallel. Volgt de koppelingen voor het uitvoeren van andere activiteiten zoals elk is voltooid.It follows the links to run other activities as each completes.

VoorwaardenConditions

Wanneer u een voorwaarde op een koppeling opgeeft, de doelactiviteit alleen wordt uitgevoerd als de voorwaarde true.When you specify a condition on a link, the destination activity is only run if the condition resolves to true. Doorgaans gebruikt u een variabele $ActivityOutput in een voorwaarde om op te halen van de uitvoer van de bronactiviteitYou typically use an $ActivityOutput variable in a condition to retrieve the output from the source activity

Voor een pijplijn-koppeling, geeft u een voorwaarde voor een enkel object en de voorwaarde wordt geëvalueerd voor elke uitvoer van object door de bronactiviteit.For a pipeline link, you specify a condition for a single object, and the condition is evaluated for each object output by the source activity. De doelactiviteit wordt vervolgens uitgevoerd voor elk object dat voldoet aan de voorwaarde.The destination activity is then run for each object that satisfies the condition. Bijvoorbeeld, met de bronactiviteit van een van Get-AzureRmVm, de syntaxis van de volgende kan worden gebruikt voor een koppeling voorwaardelijke pijplijn om op te halen, alleen virtuele machines in de resourcegroep met de naam Group1.For example, with a source activity of Get-AzureRmVm, the following syntax could be used for a conditional pipeline link to retrieve only virtual machines in the resource group named Group1.

$ActivityOutput['Get Azure VMs'].Name -match "Group1"

Voor de koppeling van een reeks wordt de voorwaarde slechts één keer geëvalueerd omdat een matrix wordt geretourneerd met de uitvoer van alle objecten van de bronactiviteit.For a sequence link, the condition is only evaluated once since a single array is returned containing all objects output from the source activity. Als gevolg hiervan is de koppeling van een reeks kan niet worden gebruikt voor het filteren van als een pijplijn-koppeling, maar gewoon wordt bepaald of de volgende activiteit wordt uitgevoerd.Because of this, a sequence link cannot be used for filtering like a pipeline link but will simply determine whether or not the next activity is run. Neem bijvoorbeeld de volgende set van activiteiten in ons runbook VM starten.Take for example the following set of activities in our Start VM runbook.

Voorwaardelijke koppeling bij reeksen

Er zijn drie verschillende reeks koppelingen die zijn deze waarden zijn opgegeven voor twee invoerparameters voor runbook voor VM-naam en de naam van de resourcegroep om te bepalen wat de juiste actie te ondernemen - verifiëren één virtuele machine starten, start alle virtuele machines in de resource groep, of alle virtuele machines in een abonnement.There are three different sequence links that are verifying values were provided to two runbook input parameters representing VM name and Resource Group name in order to determine which is the appropriate action to take - start a single VM, start all VMs in the resource group, or all VMs in a subscription. Dit is de voorwaardelijke logica voor de koppeling volgorde tussen verbinding maken met Azure en één Get-VM:For the sequence link between Connect to Azure and Get single VM, here is the condition logic:

<#
Both VMName and ResourceGroupName runbook input parameters have values
#>
(
(($VMName -ne $null) -and ($VMName.Length -gt 0))
) -and (
(($ResourceGroupName -ne $null) -and ($ResourceGroupName.Length -gt 0))
)

Wanneer u een voorwaardelijke koppeling gebruikt, worden de gegevens die beschikbaar zijn vanuit de bronactiviteit aan andere activiteiten in dat filiaal wordt gefilterd op de voorwaarde.When you use a conditional link, the data available from the source activity to other activities in that branch is filtered by the condition. Als een activiteit van de bron naar meerdere koppelingen is, klikt u vervolgens de gegevens beschikbaar zijn voor activiteiten in elke vertakking afhankelijk zijn van de voorwaarde in de koppeling die verbinding maken met dat filiaal.If an activity is the source to multiple links, then the data available to activities in each branch depend on the condition in the link connecting to that branch.

Bijvoorbeeld, de Start-AzureRmVm activiteit in het onderstaande runbook wordt gestart voor alle virtuele machines.For example, the Start-AzureRmVm activity in the runbook below starts all virtual machines. Heeft twee voorwaardelijke koppelingen.It has two conditional links. De expressie wordt gebruikt voor de eerste voorwaardelijke koppeling $ActivityOutput ['Start-AzureRmVM']. IsSuccessStatusCode - eq $true om te filteren als de Start-AzureRmVm-activiteit is voltooid.The first conditional link uses the expression $ActivityOutput['Start-AzureRmVM'].IsSuccessStatusCode -eq $true to filter if the Start-AzureRmVm activity completed successfully. De tweede maakt gebruik van de expressie $ActivityOutput ['Start-AzureRmVM']. IsSuccessStatusCode - ne $true om te filteren als de Start-AzureRmVm-activiteit is de virtuele machine te starten is mislukt.The second uses the expression $ActivityOutput['Start-AzureRmVM'].IsSuccessStatusCode -ne $true to filter if the Start-AzureRmVm activity failed to start the virtual machine.

Voorbeeld van een voorwaardelijke koppeling

Elke activiteit die volgt op de eerste koppeling en maakt gebruik van de activiteit uitvoer van Get-AzureVM krijgt alleen de virtuele machines die zijn gestart op het moment dat de Get-AzureVM werd uitgevoerd.Any activity that follows the first link and uses the activity output from Get-AzureVM will only get the virtual machines that were started at the time that Get-AzureVM was run. Elke activiteit die volgt op de tweede koppeling wordt alleen de virtuele machines die zijn gestopt op het moment dat de Get-AzureVM werd uitgevoerd.Any activity that follows the second link only gets the virtual machines that were stopped at the time that Get-AzureVM was run. Elke activiteit die de derde koppeling worden alle virtuele machines opgehaald, ongeacht hun actief is.Any activity following the third link gets all virtual machines regardless of their running state.

KoppelingenJunctions

Een verbinding is een speciale activiteit moet wachten totdat alle binnenkomende vertakkingen hebt voltooid.A junction is a special activity that waits until all incoming branches have completed. Hiermee kunt u meerdere activiteiten parallel uit te voeren en ervoor zorgen dat alle hebt voltooid voordat u doorgaat.This allows you to run multiple activities in parallel and ensure that all have completed before moving on.

Terwijl een knooppunt een onbeperkt aantal inkomende koppelingen hebben kan, mag niet meer dan één van deze koppelingen zijn een pijplijn.While a junction can have an unlimited number of incoming links, not more than one of those links can be a pipeline. Het aantal inkomende koppelingen van de takenreeks wordt niet beperkt.The number of incoming sequence links is not constrained. U mag het verbinding maken met meerdere inkomende koppelingen in de pijplijn en slaat u het runbook, maar deze mislukt wanneer deze wordt uitgevoerd.You are allowed to create the junction with multiple incoming pipeline links and save the runbook, but it fails when it is run.

Het onderstaande voorbeeld is onderdeel van een runbook die een set van virtuele machines tijdens het downloaden van patches worden toegepast op deze machines tegelijkertijd begint.The example below is part of a runbook that starts a set of virtual machines while simultaneously downloading patches to be applied to those machines. Een verbinding wordt gebruikt om ervoor te zorgen dat beide processen zijn voltooid voordat het runbook wordt hervat.A junction is used to ensure that both processes are completed before the runbook continues.

De verbinding

CycliCycles

Een cyclus is als een doel activiteit bevat een koppeling terug naar de bronactiviteit of naar een andere activiteit die uiteindelijk teruggekoppeld naar de bron.A cycle is when a destination activity links back to its source activity or to another activity that eventually links back to its source. Cycli worden momenteel niet toegestaan in het grafisch ontwerpen.Cycles are currently not allowed in graphical authoring. Als uw runbook een cyclus heeft, juist opgeslagen maar ontvangt een foutbericht wanneer deze wordt uitgevoerd.If your runbook has a cycle, it saves properly but receives an error when it runs.

Cyclus

Delen van gegevens tussen activiteitenSharing data between activities

Alle gegevens die wordt uitgevoerd door een activiteit met een uitgaande koppeling is geschreven naar de gegevensbus voor het runbook.Any data that is output by an activity with an outgoing link is written to the databus for the runbook. Elke activiteit in het runbook kunt gegevens op de gegevensbus parameterwaarden vullen of opnemen in een script gebruiken.Any activity in the runbook can use data on the databus to populate parameter values or include in script code. Een activiteit hebben toegang tot de uitvoer van een vorige activiteit in de werkstroom.An activity can access the output of any previous activity in the workflow.

Hoe de gegevens worden geschreven in de gegevensbus, is afhankelijk van het type koppeling op de activiteit.How the data is written to the databus depends on the type of link on the activity. Voor een pijplijn, de gegevens wordt uitgevoerd als veelvouden objecten.For a pipeline, the data is output as multiples objects. Voor een reeks koppeling, de gegevens wordt uitgevoerd als een matrix.For a sequence link, the data is output as an array. Als er slechts één waarde, wordt deze uitgevoerd als een matrix van één element.If there is only one value, it is output as a single element array.

U kunt toegang tot gegevens op de gegevensbus met behulp van een van twee methoden.You can access data on the databus using one of two methods. Eerst wordt met behulp van een uitvoer van activiteit gegevensbron voor het vullen van een parameter van een andere activiteit.First is using an Activity Output data source to populate a parameter of another activity. Als de uitvoer een object is, kunt u één eigenschap opgeven.If the output is an object, you can specify a single property.

Uitvoer van activiteit

U kunt ook ophalen met de uitvoer van een activiteit in een PowerShell-expressie gegevensbron of vanuit een Werkstroomscript activiteit met een variabele ActivityOutput.You can also retrieve the output of an activity in a PowerShell Expression data source or from a Workflow Script activity with an ActivityOutput variable. Als de uitvoer een object is, kunt u één eigenschap opgeven.If the output is an object, you can specify a single property. ActivityOutput variabelen gebruikt u de volgende syntaxis.ActivityOutput variables use the following syntax.

$ActivityOutput['Activity Label']
$ActivityOutput['Activity Label'].PropertyName

ControlepuntenCheckpoints

U kunt instellen controlepunten in een grafische PowerShell Workflow-runbook door te selecteren runbookcontrolepunt voor elke activiteit.You can set checkpoints in a Graphical PowerShell Workflow runbook by selecting Checkpoint runbook on any activity. Dit zorgt ervoor dat een controlepunt worden ingesteld nadat de activiteit is uitgevoerd.This causes a checkpoint to be set after the activity runs.

Controlepunt

Controlepunten worden alleen ingeschakeld in grafische PowerShell Workflow-runbooks, is niet beschikbaar in grafische runbooks.Checkpoints are only enabled in Graphical PowerShell Workflow runbooks, it is not available in Graphical runbooks. Als het runbook maakt gebruik van Azure-cmdlets, moet u een controlepunt activiteit met een Connect-AzureRmAccount volgen in het geval het runbook wordt onderbroken en opnieuw wordt opgestart vanaf dit controlepunt op een andere werknemer.If the runbook uses Azure cmdlets, you should follow any checkpointed activity with an Connect-AzureRmAccount in case the runbook is suspended and restarts from this checkpoint on a different worker.

Verificatie bij Azure-resourcesAuthenticating to Azure resources

Runbooks in Azure Automation die Azure-resources beheren vereist verificatie voor Azure.Runbooks in Azure Automation that manage Azure resources require authentication to Azure. De uitvoeren als-account (ook wel een service-principal genoemd) is de standaardmethode voor toegang tot Azure Resource Manager-resources in uw abonnement met Automation-runbooks.The Run As account (also referred to as a service principal) is the default method to access Azure Resource Manager resources in your subscription with Automation runbooks. U kunt deze functionaliteit toevoegen aan een grafisch runbook door toe te voegen de AzureRunAsConnection verbindingsasset, die met behulp van PowerShell Get-AutomationConnection -cmdlet en Connect-AzureRmAccount cmdlet toe aan het papier.You can add this functionality to a graphical runbook by adding the AzureRunAsConnection Connection asset, which is using the PowerShell Get-AutomationConnection cmdlet, and Connect-AzureRmAccount cmdlet to the canvas. Dit wordt geïllustreerd in het volgende voorbeeld:This is illustrated in the following example:

Als verificatie activiteiten uitvoeren

De activiteit uitvoeren als-verbinding ophalen (dat wil zeggen, Get-AutomationConnection) is geconfigureerd met een constante waarde gegevensbron met de naam AzureRunAsConnection.The Get Run As Connection activity (that is, Get-AutomationConnection), is configured with a constant value data source named AzureRunAsConnection.

Run As-verbindingsconfiguratie

De volgende activiteit, Connect-AzureRmAccount, voegt de geverifieerde uitvoeren als-account voor gebruik in het runbook.The next activity, Connect-AzureRmAccount, adds the authenticated Run As account for use in the runbook.

Connect-AzureRmAccount-parameterset

Belangrijk

Add-AzureRmAccount is nu een alias voor Connect-AzureRMAccount.Add-AzureRmAccount is now an alias for Connect-AzureRMAccount. Wanneer uw bibliotheek zoeken items, als u niet ziet Connect-AzureRMAccount, kunt u Add-AzureRmAccount, of u kunt uw modules bijwerken in uw Automation-Account.When searching your library items, if you do not see Connect-AzureRMAccount, you can use Add-AzureRmAccount, or you can update your modules in your Automation Account.

Voor de parameters APPLICATIONID, CERTIFICATETHUMBPRINT, en TENANTID moet u de naam van de eigenschap voor het veldpad opgeven, omdat de activiteit de uitvoer van een object met meerdere eigenschappen.For the parameters APPLICATIONID, CERTIFICATETHUMBPRINT, and TENANTID you need to specify the name of the property for the Field path because the activity outputs an object with multiple properties. Anders wanneer u het runbook uit te voeren, mislukt dit proberen te verifiëren.Otherwise when you execute the runbook, it fails attempting to authenticate. Dit is wat u moet ten minste uw runbook met de uitvoeren als-account te verifiëren.This is what you need at a minimum to authenticate your runbook with the Run As account.

Onderhouden achterwaartse compatibiliteit voor abonnees die hebben gemaakt een Automation-account met een Azure AD-gebruikersaccount voor het beheren van de klassieke Azure-implementatie of voor Azure Resource Manager-resources, de methode om te verifiëren, is de De cmdlet toevoegen-Azure-account met een referentie-element dat een Active Directory-gebruiker met toegang op het Azure-account vertegenwoordigt.To maintain backwards compatibility for subscribers who have created an Automation account using an Azure AD User account to manage Azure classic deployment or for Azure Resource Manager resources, the method to authenticate is the Add-AzureAccount cmdlet with a credential asset that represents an Active Directory user with access to the Azure account.

U kunt deze functionaliteit toevoegen aan een grafisch runbook door een referentie-element toe te voegen aan het papier gevolgd door een Add-AzureAccount-activiteit.You can add this functionality to a graphical runbook by adding a credential asset to the canvas followed by an Add-AzureAccount activity. Toevoegen-Azure-account maakt gebruik van de activiteit van de referentie voor de invoer.Add-AzureAccount uses the credential activity for its input. Dit wordt geïllustreerd in het volgende voorbeeld:This is illustrated in the following example:

Verificatie-activiteiten

U moet verifiëren aan het begin van het runbook en na elk controlepunt.You have to authenticate at the start of the runbook and after each checkpoint. Dit betekent dat met het toevoegen van een activiteit toevoeging Add-AzureAccount na elke activiteit controlepunt-werkstroom.This means adding an addition Add-AzureAccount activity after any Checkpoint-Workflow activity. U hoeft niet een activiteit van de referentie toevoegen omdat u hetzelfde kunt gebruikenYou do not need an addition credential activity since you can use the same

Uitvoer van activiteit

Runbook invoer en uitvoerRunbook input and output

RunbookinvoerRunbook input

Een runbook mogelijk invoer van een gebruiker wanneer het runbook via Azure portal wordt gestart of vanuit een ander runbook als de huidige sleutel wordt gebruikt als een onderliggend element.A runbook may require input either from a user when they start the runbook through the Azure portal or from another runbook if the current one is used as a child. Als u een runbook dat wordt gemaakt van een virtuele machine hebt, moet u er bijvoorbeeld voor kiezen om informatie te geven, zoals de naam van de virtuele machine en andere eigenschappen telkens wanneer u het runbook start.For example, if you have a runbook that creates a virtual machine, you may need to provide information such as the name of the virtual machine and other properties each time you start the runbook.

Gaat u akkoord met de invoer voor een runbook door te definiëren een of meer-invoerparameters.You accept input for a runbook by defining one or more input parameters. U opgeven waarden voor deze parameters telkens wanneer die het runbook wordt gestart.You provide values for these parameters each time the runbook is started. Wanneer u een runbook met de Azure-portal start, wordt u gevraagd waarden op te geven voor elk van de invoerparameters van het runbook.When you start a runbook with the Azure portal, it prompts you to provide values for each of the runbook's input parameters.

Invoerparameters voor een runbook toegankelijk is door te klikken op de invoer en uitvoer op de werkbalk van het runbook.You can access input parameters for a runbook by clicking the Input and output button on the runbook toolbar.

Hiermee opent u de invoer en uitvoer besturingselement kunt u een bestaande invoerparameter bewerken of een nieuwe maken door te klikken op invoer toevoegen.This opens the Input and Output control where you can edit an existing input parameter or create a new one by clicking Add input.

Invoer toevoegen

Elke invoerparameter wordt gedefinieerd door de eigenschappen in de volgende tabel:Each input parameter is defined by the properties in the following table:

EigenschapProperty BeschrijvingDescription
NaamName De unieke naam van de parameter.The unique name of the parameter. Dit mag alleen alfanumerieke tekens en mag geen spatie bevatten.This can only contain alpha numeric characters and cannot contain a space.
BeschrijvingDescription Een optionele beschrijving voor de invoerparameter.An optional description for the input parameter.
TypeType Het gegevenstype voor de parameterwaarde verwacht.Data type expected for the parameter value. De Azure portal biedt een juiste besturingselement voor het gegevenstype voor elke parameter tijdens het vragen om invoer.The Azure portal provides an appropriate control for the data type for each parameter when prompting for input.
VerplichtMandatory Hiermee geeft u op of moet een waarde worden opgegeven voor de parameter.Specifies whether a value must be provided for the parameter. Het runbook kan niet worden gestart als u geen waarde opgeeft voor de verplichte parameter waarmee de heeft geen standaardwaarde gedefinieerd.The runbook cannot be started if you do not provide a value for each mandatory parameter that does not have a default value defined.
StandaardwaardeDefault Value Hiermee geeft u op welke waarde voor de parameter wordt gebruikt als niet is opgegeven.Specifies what value is used for the parameter if one is not provided. Dit kan ofwel Null of een specifieke waarde zijn.This can either be Null or a specific value.

Runbook-uitvoerRunbook output

Gemaakt door elke activiteit die een uitgaande verbinding heeft geen gegevens worden opgeslagen in de uitvoer van het runbook.Data created by any activity that does not have an outgoing link is saved to the output of the runbook. De uitvoer wordt opgeslagen met de runbooktaak en is beschikbaar voor een bovenliggend runbook wanneer het runbook wordt gebruikt als een onderliggend element.The output is saved with the runbook job and is available to a parent runbook when the runbook is used as a child.

PowerShell-expressiesPowerShell expressions

Een van de voordelen van het grafisch ontwerpen biedt u de mogelijkheid om het bouwen van een runbook met minimale kennis van PowerShell.One of the advantages of graphical authoring is providing you with the ability to build a runbook with minimal knowledge of PowerShell. Op dit moment u hoeft te weten een deel van de PowerShell al voor het invullen van bepaalde parameterwaarden en voor de instelling koppelen voorwaarden.Currently, you do need to know a bit of PowerShell though for populating certain parameter values and for setting link conditions. Deze sectie bevat een korte inleiding in expressies voor gebruikers die mogelijk niet bekend bent met het PowerShell.This section provides a quick introduction to PowerShell expressions for those users who may not be familiar with it. Volledige details van PowerShell zijn beschikbaar op met Windows PowerShell-scripts.Full details of PowerShell are available at Scripting with Windows PowerShell.

Gegevensbron voor PowerShell-expressiePowerShell expression data source

U kunt een PowerShell-expressie gebruiken als een gegevensbron voor het vullen van de waarde van een activiteitsparameter met de resultaten van enige PowerShell-code.You can use a PowerShell expression as a data source to populate the value of an activity parameter with the results of some PowerShell code. Dit kan een enkele regel code waarmee u een eenvoudige functie of meerdere regels die bepaalde complexe logica uitvoeren.This could be a single line of code that performs some simple function or multiple lines that perform some complex logic. Elke uitvoer van een opdracht dat niet is toegewezen aan een variabele worden uitgevoerd in de waarde van parameter.Any output from a command that is not assigned to a variable is output to the parameter value.

De volgende opdracht zou bijvoorbeeld uitvoer van de huidige datum.For example, the following command would output the current date.

De volgende opdracht zou bijvoorbeeld uitvoer van de huidige datum.For example, the following command would output the current date.

Get-Date

De volgende opdrachten opbouwen van een tekenreeks van de huidige datum en deze toewijzen aan een variabele.The following commands build a string from the current date and assign it to a variable. De inhoud van de variabele worden vervolgens naar de uitvoer verzondenThe contents of the variable are then sent to the output

$string = "The current date is " + (Get-Date)
$string

De volgende opdrachten de huidige datum geëvalueerd en geretourneerd van een tekenreeks die aangeeft of de huidige dag een weekend of weekdag.The following commands evaluate the current date and return a string indicating whether the current day is a weekend or weekday.

$date = Get-Date
if (($date.DayOfWeek = "Saturday") -or ($date.DayOfWeek = "Sunday")) { "Weekend" }
else { "Weekday" }

Uitvoer van activiteitActivity output

Gebruik de variabele $ActivityOutput met de volgende syntaxis voor het gebruik van de uitvoer van een voorgaande activiteit in het runbook.To use the output from a previous activity in the runbook, use the $ActivityOutput variable with the following syntax.

$ActivityOutput['Activity Label'].PropertyName

Bijvoorbeeld, wellicht u een activiteit met een eigenschap die u de naam van een virtuele machine moet in dat geval kunt u de volgende expressie:For example, you may have an activity with a property that requires the name of a virtual machine in which case you could use the following expression:

$ActivityOutput['Get-AzureVm'].Name

Als de eigenschap die de virtuele machine vereist in plaats van alleen een eigenschap object, zou u het gehele object met de volgende syntaxis retourneren.If the property that required the virtual machine object instead of just a property, then you would return the entire object using the following syntax.

$ActivityOutput['Get-AzureVm']

U kunt de uitvoer van een activiteit ook gebruiken in een complexe expressie, zoals de volgende tekst naar de naam van de virtuele machine worden samengevoegd.You can also use the output of an activity in a more complex expression such as the following that concatenates text to the virtual machine name.

"The computer name is " + $ActivityOutput['Get-AzureVm'].Name

VoorwaardenConditions

Gebruik vergelijkingsoperators waarden vergelijken of kunt vaststellen of een waarde overeenkomt met een opgegeven patroon.Use comparison operators to compare values or determine if a value matches a specified pattern. Een vergelijking retourneert een waarde van $true en $false.A comparison returns a value of either $true or $false.

Bijvoorbeeld, de volgende voorwaarde wordt bepaald of de virtuele machine van een activiteit met de naam Get-AzureVM is momenteel gestopt.For example, the following condition determines whether the virtual machine from an activity named Get-AzureVM is currently stopped.

$ActivityOutput["Get-AzureVM"].PowerState –eq "Stopped"

De volgende voorwaarden controles of dezelfde virtuele machine anders dan in een staat is gestopt.The following condition checks whether the same virtual machine is in any state other than stopped.

$ActivityOutput["Get-AzureVM"].PowerState –ne "Stopped"

U kunt deelnemen aan meerdere voorwaarden met behulp van een logische operator zoals - en of - of.You can join multiple conditions using a logical operator such as -and or -or. Bijvoorbeeld, de volgende controles voorwaarde of dezelfde virtuele machine in het vorige voorbeeld heeft de status van gestopt of stoppen.For example, the following condition checks whether the same virtual machine in the previous example is in a state of stopped or stopping.

($ActivityOutput["Get-AzureVM"].PowerState –eq "Stopped") -or ($ActivityOutput["Get-AzureVM"].PowerState –eq "Stopping")

HashtabellenHashtables

Hashtabellen zijn naam/waarde-paren die nuttig zijn voor een set waarden geretourneerd.Hashtables are name/value pairs that are useful for returning a set of values. Eigenschappen voor bepaalde activiteiten kunnen een hash-tabel in plaats van een eenvoudige waarde verwacht.Properties for certain activities may expect a hashtable instead of a simple value. U ziet ook als hash-tabel aangeduid als een woordenlijst.You may also see as hashtable referred to as a dictionary.

U maakt een hash-tabel met de volgende syntaxis.You create a hashtable with the following syntax. Een hash-tabel kan een onbeperkt aantal vermeldingen bevatten, maar elk wordt gedefinieerd door een naam en waarde.A hashtable can contain any number of entries but each is defined by a name and value.

@{ <name> = <value>; [<name> = <value> ] ...}

De volgende expressie maakt bijvoorbeeld een hash-tabel moet worden gebruikt in de gegevensbron voor de activiteitsparameter van een die een hash-tabel met de waarden voor een zoekopdracht internet verwacht.For example, the following expression creates a hashtable to be used in the data source for an activity parameter that expected a hashtable with values for an internet search.

$query = "Azure Automation"
$count = 10
$h = @{'q'=$query; 'lr'='lang_ja';  'count'=$Count}
$h

Het volgende voorbeeld wordt de uitvoer van een activiteit met de naam Twitter-verbinding ophalen voor het vullen van een hash-tabel.The following example uses output from an activity called Get Twitter Connection to populate a hashtable.

@{'ApiKey'=$ActivityOutput['Get Twitter Connection'].ConsumerAPIKey;
    'ApiSecret'=$ActivityOutput['Get Twitter Connection'].ConsumerAPISecret;
    'AccessToken'=$ActivityOutput['Get Twitter Connection'].AccessToken;
    'AccessTokenSecret'=$ActivityOutput['Get Twitter Connection'].AccessTokenSecret}

Volgende stappenNext Steps