Start-AzureRMAutomationRunbook

Referentie

Module:: AzureRM.Automation

Start een runbooktaak.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntax

Start-AzureRMAutomationRunbook
     [-Name] <String>
     [-Parameters <IDictionary>]
     [-RunOn <String>]
     [-ResourceGroupName] <String>
     [-AutomationAccountName] <String>
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]

Start-AzureRMAutomationRunbook
     [-Name] <String>
     [-Parameters <IDictionary>]
     [-RunOn <String>]
     [-Wait]
     [-MaxWaitSeconds <Int32>]
     [-ResourceGroupName] <String>
     [-AutomationAccountName] <String>
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]

Description

De cmdlet Start-AzureRmAutomationRunbook start een Azure Automation-runbooktaak. Geef de id of naam van een runbook op.

Voorbeelden

Voorbeeld 1: Een runbooktaak starten

PS C:\>Start-AzureRmAutomationRunbook -AutomationAccountName "Contoso17" -Name "Runbk01" -ResourceGroupName "ResourceGroup01"

Met deze opdracht wordt een runbooktaak gestart voor het runbook Runbk01 in het Azure Automation-account met de naam Contoso17.

Voorbeeld 2: Een runbooktaak starten en wachten op resultaten

Start-AzureRmAutomationRunbook -AutomationAccountName "Contoso17" -Name "Runbk01" -ResourceGroupName "ResourceGroup01" -MaxWaitSeconds 1000 -Wait

Met deze opdracht wordt een runbooktaak gestart voor het runbook Runbk01 in het Azure Automation-account met de naam Contoso17. Met deze opdracht geeft u de wachtparameter op. Daarom worden resultaten geretourneerd nadat de taak is voltooid. De cmdlet wacht maximaal 1000 seconden voor de resultaten.

Parameters

-AutomationAccountName

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxWaitSeconds

Hiermee geeft u het aantal seconden op dat deze cmdlet wacht tot een taak is voltooid voordat de taak wordt verlaten. De standaardwaarde is 10800 of drie uur.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Type:	String
Aliases:	RunbookName
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Parameters

Type:	IDictionary
Aliases:	JobParameters
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RunOn

Hiermee geeft u op op welke Hybrid Worker-groep het runbook moet worden uitgevoerd.

Type:	String
Aliases:	HybridWorker
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Wait

Geeft aan dat deze cmdlet wacht tot de taak is voltooid, onderbroken of mislukt en vervolgens het besturingselement naar Azure PowerShell retourneert.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

String

Uitvoerwaarden

Job

-Deze cmdlet retourneert een taakobject , tenzij u de parameter Wait opgeeft. -Als u Wacht niet opgeeft, retourneert Azure PowerShell onmiddellijk een taakobject. -Als u Wacht opgeeft, voltooit Azure PowerShell de taak en retourneert het resultaat. -Het resultaat is geen taakobject .

PSObject