Start-AzAutomationRunbook
Startet einen Runbook-Auftrag.
Syntax
ByAsynchronousReturnJob (Standard)
Start-AzAutomationRunbook
[-Name] <String>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-Parameters <IDictionary>]
[-RunOn <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
BySynchronousReturnJobOutput
Start-AzAutomationRunbook
[-Name] <String>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-Parameters <IDictionary>]
[-RunOn <String>]
[-Wait]
[-MaxWaitSeconds <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Start-AzAutomationRunbook startet einen Azure Automation-Runbook-Auftrag.
Geben Sie die ID oder den Namen eines Runbook an.
Beispiele
Beispiel 1: Starten eines Runbook-Auftrags
Start-AzAutomationRunbook -AutomationAccountName "Contoso17" -Name "Runbk01" -ResourceGroupName "ResourceGroup01"
Dieser Befehl startet einen Runbookauftrag für das Runbook mit dem Namen Runbk01 im Azure Automation-Konto namens Contoso17.
Beispiel 2: Starten eines Python 2-Runbookauftrags mit Parametern
$params = [ordered]@{"Key1"="ValueForPosition1";"Key2"="ValueForPosition2"}
Start-AzAutomationRunbook -AutomationAccountName "Contoso17" -Name "RunbkPy01" -ResourceGroupName "ResourceGroup01" -Parameters $params
Dieser Befehl startet einen Runbookauftrag für das Python 2-Runbook mit dem Namen RunbkPy01 im Azure Automation-Konto "Contoso17" mit "ValueForPosition1" als ersten Positionsparameter und "ValueForPosition2" für die zweite.
Beispiel 3: Starten eines Runbookauftrags und Warten auf Ergebnisse
Start-AzAutomationRunbook -AutomationAccountName "Contoso17" -Name "Runbk01" -ResourceGroupName "ResourceGroup01" -MaxWaitSeconds 1000 -Wait
Dieser Befehl startet einen Runbookauftrag für das Runbook mit dem Namen Runbk01 im Azure Automation-Konto namens Contoso17.
Dieser Befehl gibt den Wait-Parameter an.
Daher werden Ergebnisse zurückgegeben, nachdem der Auftrag abgeschlossen wurde.
Das Cmdlet wartet bis zu 1000 Sekunden auf die Ergebnisse.
Parameter
-AutomationAccountName
Das Cmdlet Start-AzAutomationRunbook startet einen Azure Automation-Runbook-Auftrag.
Geben Sie die ID oder den Namen eines Runbook an.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: 1 Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Parametereigenschaften
Typ: IAzureContextContainer
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: AzContext, AzureRmContext, AzureCredential
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-MaxWaitSeconds
Gibt die Anzahl der Sekunden an, die dieses Cmdlet wartet, bis ein Auftrag abgeschlossen ist, bevor er den Auftrag abgibt.
Der Standardwert ist 10800 oder drei Stunden.
Parametereigenschaften
Typ: Int32
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
BySynchronousReturnJobOutput
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Name
Das Cmdlet Start-AzAutomationRunbook startet einen Azure Automation-Runbook-Auftrag.
Geben Sie die ID oder den Namen eines Runbook an.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: RunbookName
Parametersätze
(All)
Position: 2 Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-Parameters
Das Cmdlet Start-AzAutomationRunbook startet einen Azure Automation-Runbook-Auftrag.
Geben Sie die ID oder den Namen eines Runbook an.
Parametereigenschaften
Typ: IDictionary
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: JobParameters
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ResourceGroupName
Das Cmdlet Start-AzAutomationRunbook startet einen Azure Automation-Runbook-Auftrag.
Geben Sie die ID oder den Namen eines Runbook an.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: 0 Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-RunOn
Gibt an, auf welcher Hybridarbeitsgruppe das Runbook ausgeführt werden soll.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: HybridWorker
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-Wait
Gibt an, dass dieses Cmdlet wartet, bis der Auftrag abgeschlossen, angehalten oder fehlschlägt, und gibt dann die Steuerung an Azure PowerShell zurück.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
BySynchronousReturnJobOutput
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters .
Ausgaben