Freigeben über

Edit-SmaRunbook

  • Referenz
Modul:
Microsoft.SystemCenter.ServiceManagementAutomation

Aktualisiert 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

Die 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 zu erzwingen, dass das Cmdlet den vorhandenen Entwurf überschreibt.

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

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

Mit diesem Befehl wird das vorhandene Entwurfs-Runbook überschrieben.

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

-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

-Id

Gibt die ID eines Runbook an.

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

-Name

Gibt den Namen eines Runbook an.

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

-Overwrite

Gibt an, dass das neue Entwurfs-Runbook den vorhandenen Entwurf überschreibt, sofern vorhanden.

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

-Path

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

-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

-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