Import-SmaRunbook

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 Cmdlet Import-SmaRunbook importiert ein Runbook in die 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 ggf. den Port des SMA-Webdiensts an. Das Runbook kann vom Typ PowerShell-Skript oder -Workflow sein.

Beispiele

Beispiel 1: Importieren eines Runbooks in die Dienstverwaltungsautomatisierung

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

Dieser Befehl importiert die Runbook-Datei namens Runbook01.ps1 in den SMA-Webdienst mit Endpunkt-URL https://contoso.com/app01.

Parameter

-AuthenticationType

Gibt den Authentifizierungstyp an. Gültige Werte sind:

  • Basic
  • Windows

Der Standardwert für diesen Parameter ist Windows. Wenn Sie die Standardauthentifizierung verwenden, müssen Sie Anmeldeinformationen mithilfe des Credential-Parameters angeben.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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 Anmeldeinformationsobjekts 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

-Path

Gibt den Pfad zu einem Runbook an.

Type:String
Aliases:RunbookPath
Position:Named
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

-Tags

Gibt mindestens eine Runbook-Tags an. Sie müssen alle Tags innerhalb einer Zeichenfolge angeben, getrennt durch Kommas.

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

-WebServiceEndpoint

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

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

-WhatIf

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

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