Get-SmaRunbookDefinition
Get-SmaRunbookDefinition
Gets a runbook definition.
語法
Parameter Set: All
Get-SmaRunbookDefinition -Type <RunbookVersionType> -WebServiceEndpoint <String> [-AuthenticationType <String> ] [-Credential <PSCredential> ] [-Port <Int32> ] [ <CommonParameters>]
Parameter Set: ByRunbookId
Get-SmaRunbookDefinition -Id <String[]> -Type <RunbookVersionType> -WebServiceEndpoint <String> [-AuthenticationType <String> ] [-Credential <PSCredential> ] [-Port <Int32> ] [ <CommonParameters>]
Parameter Set: ByRunbookName
Get-SmaRunbookDefinition [-Name] <String[]> -Type <RunbookVersionType> -WebServiceEndpoint <String> [-AuthenticationType <String> ] [-Credential <PSCredential> ] [-Port <Int32> ] [ <CommonParameters>]
Parameter Set: ByVersionId
Get-SmaRunbookDefinition -VersionId <String[]> -WebServiceEndpoint <String> [-AuthenticationType <String> ] [-Credential <PSCredential> ] [-Port <Int32> ] [ <CommonParameters>]
詳細描述
The Get-SmaRunbookDefinition cmdlet gets one or more runbooks. By default, all runbook definitions of the specifies version type are returned. To get a specific runbook, specify its name or ID.
參數
-AuthenticationType<String>
Specifies the authentication type. Valid values are: Basic, Windows.
Windows is the default value. If you use Basic authentication, you must provide credentials by using the Credential parameter.
別名 |
無 |
必要？ |
false |
位置？ |
named |
預設值 |
Windows |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-Credential<PSCredential>
Specifies user credentials, as a PSCredential object, to use for the connection to the web service. To obtain a credential object, use the Get-Credential cmdlet. For more information, type Get-Help Get-Credential.
別名 |
無 |
必要？ |
false |
位置？ |
named |
預設值 |
無 |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-Id<String[]>
Specifies an array of runbook IDs.
別名 |
RunbookId |
必要？ |
true |
位置？ |
named |
預設值 |
無 |
接受管線輸入？ |
True (ByValue) |
接受萬用字元？ |
false |
-Name<String[]>
Specifies an array of runbook names.
別名 |
RunbookName |
必要？ |
true |
位置？ |
1 |
預設值 |
無 |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-Port<Int32>
Specifies the port number of the web service.
別名 |
無 |
必要？ |
false |
位置？ |
named |
預設值 |
無 |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-Type<RunbookVersionType>
Specifies a runbook version type. Valid values are: Published, Draft.
別名 |
無 |
必要？ |
true |
位置？ |
named |
預設值 |
無 |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-VersionId<String[]>
Specifies an array of runbook version IDs.
別名 |
無 |
必要？ |
true |
位置？ |
named |
預設值 |
無 |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-WebServiceEndpoint<String>
Specifies the endpoint, as a URL, of the web service. Include the protocol, for example, http:// or https://.
別名 |
無 |
必要？ |
true |
位置？ |
named |
預設值 |
無 |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
<CommonParameters>
此 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 與 -OutVariable。如需詳細資訊，請參閱 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
輸入
輸入類型是您可以使用管線處理方式傳遞給 Cmdlet 的物件類型。
輸出
輸出類型是 Cmdlet 所發出的物件類型。
範例
Example 1: Get a runbook definition by Name
This command gets the draft runbook definition of the runbook with the name RunbookDef01.
PS C:\> Get-SmaRunbookDefinition -WebServiceEndpoint "https://localhost" -Name "RunbookDef01" -Type "Draft"