JobStep-Klasse
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

JobStep-Klasse

Die JobStep-Klasse stellt einen Microsoft SQL Server-Auftragsschritt dar.

Namespace:  Microsoft.SqlServer.Management.Smo.Agent
Assembly:  Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)

[SfcElementTypeAttribute("Step")]
public sealed class JobStep : AgentObjectBase, 
	IAlterable, ICreatable, IDroppable, IRenamable, IScriptable

Der JobStep-Typ macht folgende Elemente verfügbar.

  NameBeschreibung
Öffentliche MethodeJobStep()Initialisiert eine neue Instanz der JobStep-Klasse.
Öffentliche MethodeJobStep(Job, String)Initialisiert eine neue Instanz der JobStep-Klasse für den angegebenen Auftrag unter Verwendung des angegebenen Namens.
Nach oben

  NameBeschreibung
Öffentliche EigenschaftCommandRuft die Zeichenfolge zur Befehlsausführung für den Auftragsschritt ab oder legt sie fest.
Öffentliche EigenschaftCommandExecutionSuccessCodeRuft den Prozessexitcode von einem als Auftragsschritt ausgeführten Befehlsshellprozess ab oder legt ihn fest.
Öffentliche EigenschaftDatabaseNameRuft den Namen der Datenbank ab, auf die die Befehlsausführung des Auftragsschritts beschränkt ist, oder legt ihn fest.
Öffentliche EigenschaftDatabaseUserNameRuft das Datenbank-Benutzerkonto ab, das bei der Ausführung der Befehlszeichenfolge durch den Auftragsschritt übernommen wird.
Öffentliche EigenschaftIDRuft den ID-Wert ab, durch den der Auftragsschritt eindeutig identifiziert wird, oder legt ihn fest.
Öffentliche EigenschaftJobStepFlagsDie JobStepFlags-Eigenschaft ist für die zukünftige Verwendung reserviert.
Öffentliche EigenschaftLastRunDateRuft das Datum und die Uhrzeit der letzten Ausführung des Auftragsschritts ab.
Öffentliche EigenschaftLastRunDurationRuft die Dauer der letzten Ausführung des Auftragsschritts, auf den verwiesen wird, ab.
Öffentliche EigenschaftLastRunOutcomeRuft das Ergebnis der letzten Ausführung des Auftragsschritts ab.
Öffentliche EigenschaftLastRunRetriesRuft die Anzahl der versuchten Wiederholungen bei der letzten Ausführung des Auftragsschritts ab.
Öffentliche EigenschaftNameRuft den Namen des Objekts ab oder legt ihn fest. (Geerbt von NamedSmoObject.)
Öffentliche EigenschaftOnFailActionRuft die Aktion ab, die ausgeführt wird, wenn die Ausführung des Auftragsschritts mit einem Fehler abgeschlossen wird, oder legt sie fest.
Öffentliche EigenschaftOnFailStepRuft den Auftragsschritt ab, der ausgeführt wird, nachdem die Ausführung des Auftragsschritts, auf den verwiesen wird, mit einer Fehlermeldung abgeschlossen wurde, oder legt ihn fest.
Öffentliche EigenschaftOnSuccessActionRuft die Aktion ab, die ausgeführt wird, wenn die Ausführung des Auftragsschritts erfolgreich abgeschlossen wurde, oder legt sie fest.
Öffentliche EigenschaftOnSuccessStepRuft den Auftragsschritt ab, der ausgeführt wird, nachdem die Ausführung des Auftragsschritts, auf den verwiesen wird, erfolgreich abgeschlossen wurde, oder legt ihn fest.
Öffentliche EigenschaftOSRunPriorityRuft die Planung der Ausführungsthreads für Auftragsschritte ab, die Betriebssystemtasks ausführen, oder legt sie fest.
Öffentliche EigenschaftOutputFileNameRuft den Namen und Pfad der Betriebssystemdatei ab, in der Ergebnismeldungen zum Auftragsschritt aufgezeichnet werden, oder legt sie fest.
Öffentliche EigenschaftParentRuft das Job-Objekt ab, das dem JobStep-Objekt übergeordnet ist, oder legt dieses fest.
Öffentliche EigenschaftPropertiesRuft eine Auflistung von Property-Objekten ab, die die Objekteigenschaften darstellen. (Geerbt von SqlSmoObject.)
Öffentliche EigenschaftProxyNameRuft den Namen des Microsoft SQL Server-Agent-Proxykontos ab, das für den Auftragsschritt erforderlich ist, oder legt ihn fest.
Öffentliche EigenschaftRetryAttemptsRuft ab oder legt fest, wie häufig ein Auftragsschritt maximal wiederholt wird, bevor er mit einem Fehler abgeschlossen wird.
Öffentliche EigenschaftRetryIntervalRuft die Dauer in Minuten ab, die der Microsoft SQL Server-Agent wartet, bevor er versucht, einen zuvor fehlgeschlagenen Auftragsschritt auszuführen, oder legt sie fest.
Öffentliche EigenschaftServerRuft den Namen des Servers ab, auf dem der Auftragsschritt ausgeführt wird, oder legt ihn fest.
Öffentliche EigenschaftStateRuft den Status des Objekts ab, auf das verwiesen wird. (Geerbt von SmoObjectBase.)
Öffentliche EigenschaftSubSystemRuft das Ausführungssubsystem des Microsoft SQL Server-Agents ab, mit dem der Befehlstext des Auftragsschritts interpretiert wird, oder legt es fest.
Öffentliche EigenschaftUrnRuft den Wert der URN (Uniform Resource Name)-Adresse ab, durch den das Objekt eindeutig identifiziert wird. (Geerbt von SqlSmoObject.)
Öffentliche EigenschaftUserDataRuft benutzerdefinierte Daten ab, die dem Objekt zugeordnet sind, auf das verwiesen wird, oder legt sie fest. (Geerbt von SmoObjectBase.)
Nach oben

  NameBeschreibung
Öffentliche MethodeAlterAktualisiert alle Änderungen an den Eigenschaften des JobStep-Objekts für die Microsoft SQL Server-Instanz.
Öffentliche MethodeCreateErstellt einen Auftragsschritt für die Microsoft SQL Server-Instanz, so wie im JobStep-Objekt definiert.
Öffentliche MethodeDeleteLogs(DateTime)Löscht Protokolldateien für Auftragsschritte, die vor dem angegebenen Datum liegen.
Öffentliche MethodeDeleteLogs(Int32)Löscht Protokolldateien für Auftragsschritte, deren Protokollnummern unter dem angegebenen Wert liegen.
Öffentliche MethodeDiscoverErmittelt eine Liste vom Typ Object. (Geerbt von SqlSmoObject.)
Öffentliche MethodeDropEntfernt den Auftragsschritt, auf den verwiesen wird.
Öffentliche MethodeEnumLogsGibt eine Aufzählungsliste der Protokolldateien für Auftragsschritte zurück.
Öffentliche MethodeEquals (Geerbt von Object.)
Geschützte MethodeFormatSqlVariantFormatiert ein Objekt als SqlVariant-Typ. (Geerbt von SqlSmoObject.)
Geschützte MethodeGetContextDBRuft die Kontextdatenbank ab, die diesem Objekt zugeordnet ist. (Geerbt von SqlSmoObject.)
Geschützte MethodeGetDBNameRuft den Datenbanknamen ab, der dem Objekt zugeordnet ist. (Geerbt von AgentObjectBase.)
Öffentliche MethodeGetHashCode (Geerbt von Object.)
Geschützte MethodeGetPropValueRuft einen Eigenschaftswert des SqlSmoObject-Objekts ab. (Geerbt von SqlSmoObject.)
Geschützte MethodeGetPropValueOptionalRuft einen Eigenschaftswert des SqlSmoObject-Objekts ab. (Geerbt von SqlSmoObject.)
Geschützte MethodeGetPropValueOptionalAllowNullRuft einen Eigenschaftswert des SqlSmoObject-Objekts ab. (Geerbt von SqlSmoObject.)
Geschützte MethodeGetServerObjectRuft den Server des SqlSmoObject-Objekts ab. (Geerbt von SqlSmoObject.)
Öffentliche MethodeGetType (Geerbt von Object.)
Öffentliche MethodeInitialize()Initialisiert das Objekt und erzwingt das Laden der Eigenschaften. (Geerbt von SqlSmoObject.)
Öffentliche MethodeInitialize(Boolean)Initialisiert das Objekt und erzwingt das Laden der Eigenschaften. (Geerbt von SqlSmoObject.)
Geschützte MethodeIsObjectInitializedÜberprüft, ob das Objekt initialisiert wurde. (Geerbt von SqlSmoObject.)
Geschützte MethodeIsObjectInSpaceÜberprüft, ob das Objekt isoliert vorhanden oder mit der SQL Server-Instanz verbunden ist. (Geerbt von SqlSmoObject.)
Öffentliche MethodeRefreshAktualisiert das Objekt und ruft beim nächsten Zugriff auf das Objekt Eigenschaften ab. (Geerbt von SqlSmoObject.)
Öffentliche MethodeRenameBenennt den Auftragsschritt um.
Öffentliche MethodeScript()Generiert ein Transact-SQL-Skript, das zum Neuerstellen des MicrosoftSQL Server-Agent-Auftragsschritts verwendet werden kann.
Öffentliche MethodeScript(ScriptingOptions)Generiert ein Transact-SQL-Skript, das zum Neuerstellen des Microsoft SQL Server-Agent-Auftragsschritts gemäß den Skriptoptionen verwendet werden kann.
Geschützte MethodeSetParentImplLegt das übergeordnete Element von SqlSmoObject auf den newParent-Parameter fest. (Geerbt von SqlSmoObject.)
Öffentliche MethodeToStringGibt eine String zurück, die das Objekt darstellt, auf das verwiesen wird. (Geerbt von SqlSmoObject.)
Öffentliche MethodeValidateÜberprüft den Status eines Objekts. (Geerbt von SmoObjectBase.)
Nach oben

  NameBeschreibung
Öffentliches EreignisPropertyChangedStellt das Ereignis dar, das bei Änderung einer Eigenschaft auftritt. (Geerbt von SqlSmoObject.)
Öffentliches EreignisPropertyMetadataChangedStellt das Ereignis dar, das bei Änderungen an den Eigenschaftsmetadaten auftritt. (Geerbt von SqlSmoObject.)
Nach oben

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate MethodeIAlienObject.DiscoverErmittelt alle Abhängigkeiten. Verweisen Sie nicht direkt im Code auf dieses Element. Unterstützt die SQL Server-Infrastruktur. (Geerbt von SqlSmoObject.)
Explizite SchnittstellenimplementierungPrivate MethodeIAlienObject.GetDomainRootGibt den Stamm der Domäne zurück. (Geerbt von SqlSmoObject.)
Explizite SchnittstellenimplementierungPrivate MethodeIAlienObject.GetParentRuft das übergeordnete Element dieses Objekts ab. Verweisen Sie nicht direkt im Code auf dieses Element. Unterstützt die SQL Server-Infrastruktur. (Geerbt von SqlSmoObject.)
Explizite SchnittstellenimplementierungPrivate MethodeIAlienObject.GetPropertyTypeRuft den Typ der angegebenen Eigenschaft ab. (Geerbt von SqlSmoObject.)
Explizite SchnittstellenimplementierungPrivate MethodeIAlienObject.GetPropertyValueRuft den Wert der angegebenen Eigenschaft ab. (Geerbt von SqlSmoObject.)
Explizite SchnittstellenimplementierungPrivate MethodeIAlienObject.GetUrnRuft den URN (Uniform Resource Name) des Objekts ab. Verweisen Sie nicht direkt im Code auf dieses Element. Unterstützt die SQL Server-Infrastruktur. (Geerbt von SqlSmoObject.)
Explizite SchnittstellenimplementierungPrivate MethodeIAlienObject.ResolveRuft aus dem URN (Unified Resource Name) die Instanz ab, die die Informationen zum Objekt enthält. (Geerbt von SqlSmoObject.)
Explizite SchnittstellenimplementierungPrivate MethodeIAlienObject.SetObjectStateLegt den Objektstatus auf den angegebenen SfcObjectState-Wert fest. (Geerbt von SqlSmoObject.)
Explizite SchnittstellenimplementierungPrivate MethodeIAlienObject.SetPropertyValueLegt den Eigenschaftswert fest. (Geerbt von SqlSmoObject.)
Explizite SchnittstellenimplementierungPrivate MethodeISfcPropertyProvider.GetPropertySetRuft den Schnittstellenverweis auf den Eigenschaftensatz dieses Objekts ab. Verweisen Sie nicht direkt im Code auf dieses Element. Unterstützt die SQL Server-Infrastruktur. (Geerbt von SqlSmoObject.)
Nach oben

SQL Server Agentaufträge enthalten mindestens einen aufgerufenen Ausführungseinheiten Schritte. Jeder Auftragsschritt enthält einen Textbefehl, Typ der Ausführung, die angibt, Befehlsinterpretation und Logik, die das Verhalten des Auftrags bestimmt, wenn der Schritt erfolgreich ist oder fehlschlägt. Beispielsweise kann ein Auftragsschritt enthalten:

  • Der Befehlstext. Zum Beispiel:

    DBCC CHECKDB ('Northwind') WITH NO_INFOMSGS
    
  • Ein Auftragsschrittausführungstyp: Transact-SQL beispielsweise.

  • Ein Hinweis, der vom Auftrag beenden soll, wenn der Schritt fehlschlägt.

Mit dem JobStep-Objekt können Sie:

  • Erstellen Sie einen Auftragsschritt des SQL Server.

  • Entfernen Sie einen Auftragsschritt aus einem SQL Server-Agent-Auftrag.

  • Vorhandenes Auftragsschritte, indem Sie ändern, beispielsweise den Befehlstext oder die Aktion, die bei Erfolg oder Fehler ausgeführt wird, vom Schritt.

  • Rufen Sie Details zur Ausführung des Schritts zuletzt versuchte.

Um JobStep-Objekteigenschaften abzurufen, muss der Benutzer ein Mitglied der festen Serverrolle sysadmin sein ein Element der SQLAgentUserRole-Datenbankrolle in der MSDB-Datenbank oder sein.

Um JobStep-Objekteigenschaften festzulegen, muss der Benutzer ein Mitglied der Datenbankrolle SQLAgentUserRole in der msdb-Datenbank sein, sind der Besitzer des Besitzers des Auftragsschritts oder Mitglied der festen Serverrolle sysadmin.

Um einen Auftragsschritt zu erstellen, muss der Benutzer ein Mitglied der festen Serverrolle sysadmin sein ein Element der SQLAgentUserRole-Datenbankrolle in der MSDB-Datenbank oder sein. Der Benutzer muss über die Berechtigung für beliebige Proxykonten verfügen, die für den Auftragsschritt verwendet werden.

Um einen Auftragsschritt zu löschen, muss der Benutzer ein Mitglied der Datenbankrolle SQLAgentUserRole in der msdb-Datenbank sein, sind der Besitzer des Auftragsschritts bzw. Mitglied der festen Serverrolle sysadmin.

Threadsicherheit

Alle öffentlichen, statischen Elemente dieses Typs (Shared in Microsoft Visual Basic) sind für Vorgänge mit mehreren Threads sicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.  

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2016 Microsoft