Import-AzAutomationRunbook

  • Referenz
Modul:
Az.Automation

Importiert ein Automatisierungs-Runbook.

Syntax

Import-AzAutomationRunbook
      [-Path] <String>
      [-Description <String>]
      [-Name <String>]
      [-Tags <IDictionary>]
      -Type <String>
      [-LogProgress <Boolean>]
      [-LogVerbose <Boolean>]
      [-Published]
      [-Force]
      [-ResourceGroupName] <String>
      [-AutomationAccountName] <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Import-AzAutomationRunbook importiert ein Azure Automation-Runbook. Geben Sie den Pfad zu einer wps_2 Skriptdatei (PS1) an, die für wps_2- und wps_2 Workflow-Runbooks, (Graphrunbook)-Datei für grafische Runbooks oder (.py)-Datei für Python 2-Runbooks importiert werden soll. Für wps_2 Workflowrunbooks muss das Skript eine einzelne wps_2 Workflowdefinition enthalten, die dem Namen der Datei entspricht.

Beispiele

Beispiel 1: Importieren eines Runbook aus einer Datei

$Tags = @{"tag01"="value01"; "tag02"="value02"}
Import-AzAutomationRunbook -Path .\GraphicalRunbook06.graphrunbook -Tags $Tags -ResourceGroupName "ResourceGroup01" -AutomationAccountName "AutomationAccount01" -Type GraphicalPowershell

Der erste Befehl weist der variablen $Tags zwei Schlüssel/Wert-Paare zu. Mit dem zweiten Befehl wird ein grafisches Runbook namens "GraphicalRunbook06" in das Automatisierungskonto namens AutomationAccount01 importiert. Der Befehl weist auch die in $Tags gespeicherten Tags zu.

Beispiel 2

Importiert ein Automatisierungs-Runbook. (automatisch generiert)

Import-AzAutomationRunbook -AutomationAccountName 'AutomationAccount01' -Name 'Configuration01' -Path .\GraphicalRunbook06.graphrunbook -Published -ResourceGroupName 'ResourceGroup01' -Type PowerShell

Parameter

-AutomationAccountName

Gibt den Namen des Automatisierungskontos an, in das dieses Cmdlet ein Runbook importiert.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für das importierte Runbook an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Force

ps_force

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LogProgress

Gibt an, ob das Runbook Statusinformationen protokolliert.

Typ:Nullable<T>[Boolean]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LogVerbose

Gibt an, ob das Runbook detaillierte Informationen protokolliert.

Typ:Nullable<T>[Boolean]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des Runbook an, das dieses Cmdlet importiert.

Typ:String
Aliase:RunbookName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Pfad einer PS1- oder GRAPHRUNBOOK-Datei an, die dieses Cmdlet importiert.

Typ:String
Aliase:SourcePath
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Published

Gibt an, dass dieses Cmdlet das von ihr importierte Runbook veröffentlicht.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, für die dieses Cmdlet ein Runbook importiert.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Tags

Schlüssel-Wert-Paare in Form einer Hashtabelle. Beispiel: @{key0="value0"; key1=$null; key2="value2"}

Typ:IDictionary
Aliase:Tag
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Type

Gibt den Typ des von diesem Cmdlet erstellten Runbook an. Gültige Werte sind:

  • PowerShell
  • PowerShell72
  • GraphicPowerShell
  • PowerShellWorkflow
  • GraphicalPowerShellWorkflow
  • Graph
  • Python2
  • Python3 Der Wert Graph ist veraltet. Es entspricht GraphicPowerShellWorkflow.
Typ:String
Zulässige Werte:PowerShell, GraphicalPowerShell, PowerShellWorkflow, GraphicalPowerShellWorkflow, Graph, Python2, Python3, Powershell72
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

IDictionary

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Ausgaben

Runbook