Share via


Get-SmaRunbookDefinition

Ruft eine Runbook-Definition ab.

Syntax

Get-SmaRunbookDefinition
   -Type <RunbookVersionType>
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SmaRunbookDefinition
   -Id <String[]>
   -Type <RunbookVersionType>
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SmaRunbookDefinition
   [-Name] <String[]>
   -Type <RunbookVersionType>
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SmaRunbookDefinition
   -VersionId <String[]>
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet "Get-SmaRunbookDefinition " ruft mindestens ein Runbooks ab. Standardmäßig werden alle Runbookdefinitionen des angegebenen Versionstyps zurückgegeben. Um ein bestimmtes Runbook abzurufen, geben Sie den Namen oder die ID an.

Beispiele

Beispiel 1: Abrufen einer Runbookdefinition nach Name

PS C:\>Get-SmaRunbookDefinition -WebServiceEndpoint "https://localhost" -Name "RunbookDef01" -Type "Draft"

Dieser Befehl ruft die Entwurfsausführungsdefinition des Runbook mit dem Namen RunbookDef01 ab.

Parameter

-AuthenticationType

Gibt den Authentifizierungstyp an. Gültige Werte sind:

  • Basic
  • Windows

Der Standardwert lautet Windows. Wenn Sie die Standardauthentifizierung verwenden, müssen Sie Anmeldeinformationen mithilfe des Parameters "Anmeldeinformationen " angeben.

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

-Credential

Gibt ein PSCredential-Objekt für die Verbindung mit dem SMA-Webdienst an. Verwenden Sie zum Abrufen eines Anmeldeinformationenobjekts das Cmdlet Get-Credential. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

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

-Id

Gibt ein Array von Runbook-IDs an, von denen dieses Cmdlet Runbook-Definitionen abruft.

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

-Name

Gibt ein Array von Runbooknamen an, von dem dieses Cmdlet Runbookdefinitionen abruft.

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

-Port

Gibt die Portnummer des SMA-Webdiensts an.

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

-Type

Gibt einen Runbook-Versionstyp an. Gültige Werte sind:

  • Veröffentlicht
  • Entwurf
Type:RunbookVersionType
Accepted values:Published, Draft
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VersionId

Gibt ein Array von Runbook-Versions-IDs an.

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

-WebServiceEndpoint

Gibt den Endpunkt als URL des SMA-Webdiensts an. Sie müssen das Protokoll beispielsweise http:// oder https:// einschließen.

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