Freigeben über

New-AzureRMAutomationWebhook

  • Referenz
Modul:
AzureRM.Automation

Erstellt einen Webhook für ein Automatisierungs-Runbook.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

New-AzureRMAutomationWebhook
   [-Name] <String>
   [-RunbookName] <String>
   [-IsEnabled] <Boolean>
   [-ExpiryTime] <DateTimeOffset>
   [-Parameters <IDictionary>]
   [-Force]
   [-RunOn <String>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzureRmAutomationWebhook erstellt einen Webhook für ein Azure Automation-Runbook. Speichern Sie unbedingt die von diesem Cmdlet zurückgegebene Webhook-URL, da sie nicht erneut abgerufen werden kann.

Beispiele

Beispiel 1: Erstellen eines Webhooks

PS C:\>$Webhook = New-AzureRmAutomationWebhook -Name "Webhook06" -IsEnabled $True -ExpiryTime "10/2/2016" -RunbookName "ContosoRunbook" -ResourceGroup "ResourceGroup01" -AutomationAccountName "AutomationAccount01" -Force

Mit diesem Befehl wird ein Webhook namens "Webhook06" für das Runbook "ContosoRunbook" im Automatisierungskonto namens "AutomationAccount01" erstellt. Der Befehl speichert den Webhook in der variablen $Webhook. Der Webhook ist aktiviert. Der Webhook läuft zum angegebenen Zeitpunkt ab. Dieser Befehl stellt keine Werte für Webhook-Parameter bereit. Dieser Befehl gibt den Force-Parameter an. Daher werden Sie nicht zur Bestätigung aufgefordert.

Beispiel 2: Erstellen eines Webhooks mit Parametern

PS C:\>$Params = @{"StringParam"="Hello World";"IntegerParam"=32}
PS C:\> $Webhook = New-AzureRmAutomationWebhook -Name "Webhook11" -Parameters $Params -IsEnabled $True -ExpiryTime "10/2/2016" -RunbookName "ContosoRunbook" -ResourceGroup "ResourceGroup01" -AutomationAccountName "AutomationAccount01" -Force

Der erste Befehl erstellt ein Wörterbuch mit Parametern und speichert sie in der variablen $Params. Der zweite Befehl erstellt einen Webhook namens "Webhook11" für das Runbook "ContosoRunbook" im Automatisierungskonto namens "AutomationAccount01". Der Befehl weist den Webhook die Parameter in $Params zu.

Parameter

-AutomationAccountName

Gibt den Namen eines Automatisierungskontos an, in dem dieses Cmdlet einen Webhook erstellt.

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:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExpiryTime

Gibt die Ablaufzeit für den Webhook als DateTimeOffset -Objekt an. Sie können eine Zeichenfolge oder eine DateTime angeben, die in ein gültiges DateTimeOffset konvertiert werden kann.

Typ:DateTimeOffset
Position:5
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Force

ps_force

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

-IsEnabled

Gibt an, ob der Webhook aktiviert ist.

Typ:Boolean
Position:4
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen Namen für den Webhook an.

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

-Parameters

Gibt ein Wörterbuch mit Schlüssel-Wert-Paaren an. Die Schlüssel sind die Namen des Runbook-Parameters. Die Werte sind die Runbook-Parameterwerte. Wenn das Runbook als Reaktion auf einen Webhook gestartet wird, werden diese Parameter an das Runbook übergeben.

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, für die dieses Cmdlet einen Webhook erstellt.

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

-RunbookName

Gibt den Namen des Runbook an, das dem Webhook zugeordnet werden soll.

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

-RunOn

Optionaler Name der Hybridarbeitsgruppe, die das Runbook ausführen soll

Typ:String
Aliase:HybridWorker
Position:Named
Standardwert:None
Erforderlich:False
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

Boolean

DateTimeOffset

Ausgaben

Webhook