Start-AzureRMAutomationRunbook

Referencia

Módulo:: AzureRM.Automation

Inicia un trabajo de runbook.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

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

El cmdlet Start-AzureRmAutomationRunbook inicia un trabajo de runbook de Azure Automation. Especifique el identificador o el nombre de un runbook.

Ejemplos

Ejemplo 1: Iniciar un trabajo de runbook

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

Este comando inicia un trabajo de runbook para el runbook denominado Runbk01 en la cuenta de Azure Automation denominada Contoso17.

Ejemplo 2: Iniciar un trabajo de runbook y esperar resultados

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

Este comando inicia un trabajo de runbook para el runbook denominado Runbk01 en la cuenta de Azure Automation denominada Contoso17. Este comando especifica el parámetro Wait . Por lo tanto, devuelve resultados una vez completado el trabajo. El cmdlet espera hasta 1000 segundos para los resultados.

Parámetros

-AutomationAccountName

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

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

-MaxWaitSeconds

Especifica el número de segundos que este cmdlet espera a que finalice un trabajo antes de abandonar el trabajo. El valor predeterminado es 10800 o tres horas.

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

Especifica el grupo de Hybrid Worker en el que se va a ejecutar el runbook.

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

-Wait

Indica que este cmdlet espera a que el trabajo se complete, suspenda o produzca un error y, a continuación, devuelve el control a Azure PowerShell.

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

Entradas

String

Salidas

Job

-Este cmdlet devuelve un objeto Job , a menos que especifique el parámetro Wait . -Si no especifica Wait, Azure PowerShell devuelve inmediatamente un objeto Job . -Si especifica Wait, Azure PowerShell completa el trabajo y, a continuación, devuelve el resultado. -El resultado no es un objeto Job .

PSObject