Freigeben über


New-AzureRMAutomationWebhook

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 weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. 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