Start-AzureRMAutomationRunbook

Referência

Módulo:: AzureRM.Automation

Inicia um trabalho de runbook.

Aviso

O módulo do PowerShell do AzureRM foi oficialmente preterido em 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o 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

O cmdlet Start-AzureRmAutomationRunbook inicia um trabalho de runbook de Automação do Azure. Especifique a ID ou o nome de um runbook.

Exemplos

Exemplo 1: Iniciar um trabalho de runbook

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

Esse comando inicia um trabalho de runbook para o runbook chamado Runbk01 na conta de Automação do Azure chamada Contoso17.

Exemplo 2: Iniciar um trabalho de runbook e aguardar os resultados

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

Esse comando inicia um trabalho de runbook para o runbook chamado Runbk01 na conta de Automação do Azure chamada Contoso17. Este comando especifica o parâmetro Wait . Portanto, ele retorna resultados após a conclusão do trabalho. O cmdlet aguarda até 1000 segundos pelos resultados.

Parâmetros

-AutomationAccountName

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

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

-MaxWaitSeconds

Especifica o número de segundos que esse cmdlet aguarda a conclusão de um trabalho antes de abandoná-lo. O valor padrão é 10800 ou três 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 em qual Grupo de Trabalho Híbrido executar o runbook.

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

-Wait

Indica que esse cmdlet aguarda a conclusão, suspensão ou falha do trabalho e, em seguida, retorna o controle para o Azure PowerShell.

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

Entradas

String

Saídas

Job

-Este cmdlet retorna um objeto Job , a menos que você especifique o parâmetro Wait . -Se você não especificar Wait, o Azure PowerShell retornará um objeto Job imediatamente. -Se você especificar Esperar, o Azure PowerShell concluirá o trabalho e retornará o resultado. -O resultado não é um objeto Job .

PSObject