Edit-SmaRunbook

  • Referenz
Modul:
Microsoft.SystemCenter.ServiceManagementAutomation

Aktualisierungen das Entwurfsfeld eines Runbook.

Syntax

Edit-SmaRunbook
    [-Name <String>]
    -Path <String>
    [-Overwrite]
    -WebServiceEndpoint <String>
    [-Port <Int32>]
    [-AuthenticationType <String>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Edit-SmaRunbook
    [-Id <String>]
    -Path <String>
    [-Overwrite]
    -WebServiceEndpoint <String>
    [-Port <Int32>]
    [-AuthenticationType <String>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Edit-SmaRunbook aktualisiert das Entwurfsfeld eines Runbook. Stellen Sie eine Windows PowerShell Skriptdatei (.ps1) bereit, die ein Runbook enthält, das zum Entwurfs-Runbook wird. Wenn bereits ein Entwurf vorhanden ist, verwenden Sie den Parameter Overwrite , um das Cmdlet zu erzwingen, den vorhandenen Entwurf zu überschreiben.

Um einen bestimmten Typ von Runbook (Windows PowerShell Skript oder Workflow) zu bearbeiten, müssen Sie ein neues Runbook dieses Typs erstellen.

Beispiele

Beispiel 1: Überschreiben eines vorhandenen Entwurfsausführungsbuchs

PS C:\> Edit-SmaRunbook -Name "Runbk01" -WebServiceEndpoint "https://contoso.com" -Path "App01.ps1" -Overwrite

Mit diesem Befehl wird das vorhandene Runbook überschrieben.

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 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

-Id

Gibt die ID eines Runbook an.

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

-Name

Gibt den Namen eines Runbook an.

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

-Overwrite

Gibt an, dass der neue Entwurfslaufbuch den vorhandenen Entwurf überschreibt, falls vorhanden.

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

-Path

Gibt einen Pfad zum neuen Entwurfs-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

-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

-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