Freigeben über

Get-SmaRunbookDefinition

  • Referenz
Modul:
Microsoft.SystemCenter.ServiceManagementAutomation

Ruft eine Runbookdefinition 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 ein oder mehrere 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 anhand des Namens

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

Dieser Befehl ruft die Entwurfs-Runbookdefinition des Runbook mit dem Namen RunbookDef01 ab.

Parameter

-AuthenticationType

Gibt den Authentifizierungstyp an. Gültige Werte sind:

  • Grundlegend
  • Fenster

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

Typ:String
Zulässige Werte:Basic, Windows
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt ein PSCredential -Objekt für die Verbindung mit dem SMA-Webdienst an. Verwenden Sie das Cmdlet Get-Credential, um ein Anmeldeinformationsobjekt abzurufen. Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

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

Typ:String[]
Aliase:RunbookId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

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

Typ:String[]
Aliase:RunbookName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Port

Gibt die Portnummer des SMA-Webdiensts an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Type

Gibt einen Runbookversionstyp an. Gültige Werte sind:

  • Veröffentlicht
  • Entwurf
Typ:RunbookVersionType
Zulässige Werte:Published, Draft
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VersionId

Gibt ein Array von Runbook-Versions-IDs an.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WebServiceEndpoint

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False