Freigeben über

Import-SmaRunbook

  • Referenz
Modul:
Microsoft.SystemCenter.ServiceManagementAutomation

Importiert ein Runbook in SMA.

Syntax

Import-SmaRunbook
      -Path <String>
      [-Tags <String>]
      -WebServiceEndpoint <String>
      [-Port <Int32>]
      [-AuthenticationType <String>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Import-SmaRunbook Cmdlet importiert ein Runbook in Service Management Automation (SMA). Das Runbook muss eine Windows PowerShell-Skriptdatei (.ps1) sein. Geben Sie den Pfad eines Runbook und des Webdienstendpunkts an. Geben Sie bei Bedarf den Port des SMA-Webdiensts an. Das Runbook kann vom Typ PowerShell-Skript oder -Workflow sein.

Beispiele

Beispiel 1: Importieren eines Runbook in die Dienstverwaltungsautomatisierung

PS C:\> Import-SmaRunbook -Path "./Runbook01.ps1" -WebServiceEndpoint "https://contoso.com/app01"

Mit diesem Befehl wird die Runbookdatei namens Runbook01.ps1 in den SMA-Webdienst importiert, der Endpunkt-URL https://contoso.com/app01enthält.

Parameter

-AuthenticationType

Gibt den Authentifizierungstyp an. Gültige Werte sind:

  • Grundlegend
  • Fenster

Der Standardwert für diesen Parameter 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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
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

-Path

Gibt den Pfad zu einem Runbook an.

Typ:String
Aliase:RunbookPath
Position:Named
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

-Tags

Gibt ein oder mehrere Runbooktags an. Sie müssen alle Tags innerhalb einer Zeichenfolge angeben, getrennt durch Kommas.

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

-WebServiceEndpoint

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

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

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False