Start-SmaRunbook

启动 Runbook 作业。

语法

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>]

说明

Start-SmaRunbook cmdlet 启动 Runbook 作业。 指定 Runbook 和 Web 服务终结点的 ID 或名称。 如有必要,请指定 Service Management Automation (SMA) Web 服务的端口。

示例

示例 1:启动 Runbook 作业

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

此命令启动名为 Runbk01 的 Runbook,并指定 Runbook 作业的参数。

参数

-AuthenticationType

指定身份验证类型。 有效值为:

  • 基本
  • Windows

此参数的默认值为 Windows。 如果使用基本身份验证,则必须使用 Credential 参数提供 凭据

Type:String
Accepted values:Basic, Windows
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Credential

指定连接到 SMA Web 服务的 PSCredential 对象。 若要获取凭据对象,请使用 Get-Credential cmdlet。 要了解详情,请键入 Get-Help Get-Credential

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

-Id

指定 Runbook 的 ID。

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

-Name

指定 Runbook 的名称。

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

-Parameters

指定键和值对的哈希表。 哈希表中的键是 Runbook 参数名称。 哈希表中的值是 Runbook 参数值。

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

-Port

指定 SMA Web 服务的端口号。

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

-ScheduleName

指定要启动 Runbook 的作业计划的名称。 若要在 SMA 中创建计划,请使用 Set-SmaSchedule cmdlet。

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

-WebServiceEndpoint

将终结点指定为 SMA Web 服务的 URL。 必须包括协议,例如 http:// 或 https://。

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

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

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