Compartilhar via

Start-SmaRunbook

  • Referência
Módulo:
Microsoft.SystemCenter.ServiceManagementAutomation

Inicia um trabalho de runbook.

Sintaxe

Start-SmaRunbook
     [-Name <String>]
     [-Parameters <IDictionary>]
     [-ScheduleName <String>]
     -WebServiceEndpoint <String>
     [-Port <Int32>]
     [-AuthenticationType <String>]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-SmaRunbook
     [-Id <String>]
     [-Parameters <IDictionary>]
     [-ScheduleName <String>]
     -WebServiceEndpoint <String>
     [-Port <Int32>]
     [-AuthenticationType <String>]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

O cmdlet Start-SmaRunbook inicia um trabalho de runbook. Especifique a ID ou o nome de um runbook e o ponto de extremidade do serviço Web. Se necessário, especifique a porta do serviço Web SMA (Automação de Gerenciamento de Serviços).

Exemplos

Exemplo 1: Iniciar um trabalho de runbook

PS C:\> Start-SmaRunbook -WebServiceEndpoint https://localhost -Name "Runbk01" -Parameters @{"StringParam"="Value"; "IntParam"=2}

Esse comando inicia o runbook chamado Runbk01, especificando os parâmetros para o trabalho de runbook.

Parâmetros

-AuthenticationType

Especifica o tipo de autenticação. Os valores válidos são:

  • Básico
  • Windows

O valor padrão para esse parâmetro é Windows. Se você usar a autenticação Básica, deverá fornecer credenciais usando o parâmetro credencial.

Tipo:String
Valores aceitos:Basic, Windows
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Credential

Especifica um objeto PSCredential para a conexão com o serviço Web SMA. Para obter um objeto de credencial, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica a ID de um runbook.

Tipo:String
Aliases:RunbookId
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica o nome de um runbook.

Tipo:String
Aliases:RunbookName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Parameters

Especifica uma tabela hash de pares chave e valor. As chaves na tabela de hash são os nomes de parâmetro do runbook. Os valores na tabela de hash são os valores de parâmetro do runbook.

Tipo:IDictionary
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Port

Especifica o número da porta do serviço Web SMA.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScheduleName

Especifica o nome de um agendamento de trabalho no qual iniciar o runbook. Para criar um agendamento no SMA, use o cmdlet Set-SmaSchedule.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WebServiceEndpoint

Especifica o ponto de extremidade, como UMA URL, do serviço Web SMA. Você deve incluir o protocolo, por exemplo, http:// ou https://.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False