JobStep 클래스
The JobStep class represents a Microsoft SQL Server job step.
상속 계층
System. . :: . .Object
Microsoft.SqlServer.Management.Smo. . :: . .SmoObjectBase
Microsoft.SqlServer.Management.Smo. . :: . .SqlSmoObject
Microsoft.SqlServer.Management.Smo. . :: . .NamedSmoObject
Microsoft.SqlServer.Management.Smo.Agent. . :: . .AgentObjectBase
Microsoft.SqlServer.Management.Smo.Agent..::..JobStep
네임스페이스: Microsoft.SqlServer.Management.Smo.Agent
어셈블리: Microsoft.SqlServer.Smo(Microsoft.SqlServer.Smo.dll)
구문
‘선언
<SfcElementTypeAttribute("Step")> _
Public NotInheritable Class JobStep _
Inherits AgentObjectBase _
Implements IAlterable, ICreatable, IDroppable, IRenamable, _
IScriptable
‘사용 방법
Dim instance As JobStep
[SfcElementTypeAttribute("Step")]
public sealed class JobStep : AgentObjectBase,
IAlterable, ICreatable, IDroppable, IRenamable, IScriptable
[SfcElementTypeAttribute(L"Step")]
public ref class JobStep sealed : public AgentObjectBase,
IAlterable, ICreatable, IDroppable, IRenamable, IScriptable
[<SealedAttribute>]
[<SfcElementTypeAttribute("Step")>]
type JobStep =
class
inherit AgentObjectBase
interface IAlterable
interface ICreatable
interface IDroppable
interface IRenamable
interface IScriptable
end
public final class JobStep extends AgentObjectBase implements IAlterable, ICreatable, IDroppable, IRenamable, IScriptable
JobStep 유형에서 다음 멤버를 표시합니다.
생성자
| 이름 | 설명 | |
|---|---|---|
.gif "공용 메서드") |
JobStep() () () () | Initializes a new instance of the JobStep class. |
|
JobStep(Job, String) | Initializes a new instance of the JobStep class for the specified job and with the specified name. |
맨 위로 이동
속성
| 이름 | 설명 | |
|---|---|---|
.gif "공용 속성") |
Command | Gets or sets the command execution string for the job step. |
|
CommandExecutionSuccessCode | Gets or sets the process exit code from a command shell process executed as a job step. |
|
DatabaseName | Gets or sets the name of the database to which the job step command execution is confined. |
|
DatabaseUserName | Gets or sets the database user account that the job step assumes when executing the command string. |
.gif "보호된 속성") |
ExecuteForScalar | 스칼라 옵션을 실행하도록 개체를 설정할지 여부를 지정하는 Boolean 속성 값을 가져오거나 설정합니다. (SqlSmoObject에서 상속됨) |
|
ID | Gets or sets the ID value that uniquely identifies the job step. |
|
IsTouched | 개체 속성이 업데이트되었으나 아직 서버에 유지되는지 여부를 지정하는 Boolean 속성 값을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
JobStepFlags | The JobStepFlags property is reserved for future use. |
|
LastRunDate | Gets the date and time when the job step was last executed. |
|
LastRunDuration | Gets the time that the referenced job step took to run when it was last executed. |
|
LastRunOutcome | Gets the outcome of the job step when it was last executed. |
|
LastRunRetries | Gets the number of retries that were attempted when the job step was last executed. |
|
Name | Gets or sets the name of the object. (NamedSmoObject에서 상속됨) |
|
ObjectInSpace | 개체가 분리되어 존재하는지, 아니면 SQL Server 인스턴스에 직접 또는 간접 연결되는지를 지정하는 Boolean 속성 값을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
OnFailAction | Gets or sets the action to take when the job step finishes execution with failure. |
|
OnFailStep | Gets or sets the job step that is executed after the referenced job step finishes execution with a completion status of failure. |
|
OnSuccessAction | Gets or sets the action to take when the job step finishes execution with success. |
|
OnSuccessStep | Gets or sets the job step that is executed after the referenced job step finishes execution with a completion status of success. |
|
OSRunPriority | Gets or sets the execution thread scheduling for job steps executing operating system tasks. |
|
OutputFileName | Gets or sets the name and path of the operating system file that records job step result message text. |
|
Parent | Gets or sets the Job object that is the parent of the JobStep object. |
|
Properties | 개체 속성을 나타내는 Property 개체의 컬렉션을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
ProxyName | Gets or sets the name of the Microsoft SQL Server Agent proxy account that is required by the job step. |
|
RetryAttempts | Gets or sets the maximum number of times a job step is retried before it is returned with a completion status of failure. |
|
RetryInterval | Gets or sets the number of minutes that Microsoft SQL Server Agent waits before trying to execute a job step that has previously failed. |
|
ScalarResult | 참조된 개체의 스칼라 결과를 가져옵니다. (SqlSmoObject에서 상속됨) |
|
Server | Gets or sets the name of the server on which the job step runs. |
|
State | Gets the state of the referenced object. (SmoObjectBase에서 상속됨) |
|
SubSystem | Gets or sets the Microsoft SQL Server Agent execution subsystem used to interpret job step command text. |
|
Urn | 개체를 고유하게 식별하는 URN(Uniform Resource Name) 주소 값을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
UserData | Gets or sets user-defined data associated with the referenced object. (SmoObjectBase에서 상속됨) |
맨 위로 이동
메서드
| 이름 | 설명 | |
|---|---|---|
.gif "보호된 메서드") |
AddDatabaseContext(StringCollection) | queries 매개 변수로 식별되는 쿼리 컬렉션에 데이터베이스 컨텍스트를 추가합니다. (SqlSmoObject에서 상속됨) |
|
AddDatabaseContext(StringCollection, ScriptingOptions) | queries 매개 변수로 식별되는 쿼리 컬렉션에 지정한 스크립팅 옵션을 사용하여 데이터베이스 컨텍스트를 추가합니다. (SqlSmoObject에서 상속됨) |
|
Alter | Updates any JobStep object property changes on instance of Microsoft SQL Server. |
|
AlterImpl | 개체 변경 이벤트를 활성화합니다. (SqlSmoObject에서 상속됨) |
|
AlterImplFinish | 개체 변경 이벤트가 완료되면 호출되는 메서드입니다. (SqlSmoObject에서 상속됨) |
|
AlterImplInit | 개체 변경 이벤트가 초기화되면 호출되는 메서드입니다. (SqlSmoObject에서 상속됨) |
|
AlterImplWorker | 변경 메서드를 호출합니다. (SqlSmoObject에서 상속됨) |
|
BindDefaultImpl | 매개 변수로 식별된 기본 항목을 바인딩합니다. (SqlSmoObject에서 상속됨) |
|
BindRuleImpl | 규칙 스키마를 매개 변수로 식별된 열과 규칙에 바인딩합니다. (SqlSmoObject에서 상속됨) |
|
CheckCollation | collationName 매개 변수로 식별된 데이터 정렬 메서드를 사용하여 스크립팅 옵션의 순서를 확인합니다. (SqlSmoObject에서 상속됨) |
|
CheckObjectState() () () () | 참조된 개체의 상태를 검사합니다. (SqlSmoObject에서 상속됨) |
|
CheckObjectState(Boolean) | 개체가 아직 만들어지지 않았을 경우 예외를 발생시키도록 지정하는 옵션을 사용하여 참조된 개체의 상태를 검사합니다. (SqlSmoObject에서 상속됨) |
|
CheckObjectStateImpl | SqlSmoObject 의 상태를 확인합니다. (SqlSmoObject에서 상속됨) |
|
CheckVersion100 | SQL Server 버전이 SQL Server 2008인지 여부를 확인합니다. (SqlSmoObject에서 상속됨) |
|
CheckVersion80 | SQL Server 2000에서 개체의 유효성을 검사합니다. (SqlSmoObject에서 상속됨) |
|
CheckVersion80SP3 | SQL Server 2000 SP3에서 개체의 유효성을 검사합니다. (SqlSmoObject에서 상속됨) |
|
CheckVersion90 | SQL Server 2005에서 개체의 유효성을 검사합니다. (SqlSmoObject에서 상속됨) |
|
CheckVersionBelow90 | SQL Server 버전이 SQL Server 2005 이전 버전인지 여부를 확인합니다. (SqlSmoObject에서 상속됨) |
|
CleanObject | 개체를 수정되지 않은 상태로 설정합니다. (SqlSmoObject에서 상속됨) |
|
Create | Creates a job step on the instance of Microsoft SQL Server as defined by the JobStep object. |
|
CreateImpl | 스크립팅 옵션을 사용하여 개체를 만듭니다. (SqlSmoObject에서 상속됨) |
|
CreateImplFinish | 만들기 이벤트가 완료되면 호출되는 메서드입니다. (SqlSmoObject에서 상속됨) |
|
CreateImplInit | 만들기 이벤트가 초기화되면 호출되는 메서드입니다. (SqlSmoObject에서 상속됨) |
|
DeleteLogs(DateTime) | Deletes job step log files that are older than the specified date. |
|
DeleteLogs(Int32) | Deletes job step log files that have log numbers lower than the specified value. |
|
Discover | Object 유형의 목록을 검색합니다. (SqlSmoObject에서 상속됨) |
|
Drop | Removes the referenced job step. |
|
DropImpl | SqlSmoObject 를 삭제합니다. (SqlSmoObject에서 상속됨) |
|
DropImplWorker | 삭제 메서드를 호출합니다. (SqlSmoObject에서 상속됨) |
|
EnumLogs | Returns an enumerated list of the job step log files. |
|
EnumScriptImpl | so 매개 변수로 지정한 스크립트를 열거합니다. (SqlSmoObject에서 상속됨) |
|
EnumScriptImplWorker | so 매개 변수로 지정한 스크립트를 열거하는 메서드를 호출합니다. (SqlSmoObject에서 상속됨) |
|
EnumScriptImplWorkerSOChanged | 개체의 스크립팅 옵션을 설명하는 IEnumerable 문자열을 반환합니다. (SqlSmoObject에서 상속됨) |
|
Equals | (Object에서 상속됨) |
|
ExecuteNonQuery | (SqlSmoObject에서 상속됨) |
|
Finalize | (Object에서 상속됨) |
|
FormatSqlVariant | 개체를 SqlVariant 형식으로 지정합니다. (SqlSmoObject에서 상속됨) |
|
GenerateDataSpaceFileStreamScript | 데이터 파일을 만드는 스크립트를 생성합니다. (SqlSmoObject에서 상속됨) |
|
GenerateDataSpaceScript | 데이터 파일에 공간을 할당하는 스크립트를 생성합니다. (SqlSmoObject에서 상속됨) |
|
GetBindDefaultScript | defSchema 및 defName 매개 변수로 지정한 기본값을 바인딩하는 스크립트를 가져옵니다. (SqlSmoObject에서 상속됨) |
|
GetBindRuleScript | 바인딩 규칙을 지정하는 스크립트를 가져옵니다. (SqlSmoObject에서 상속됨) |
|
GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | SqlSmoObject 의 부울 매개 변수를 할당합니다. (SqlSmoObject에서 상속됨) |
|
GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | SqlSmoObject 의 부울 속성을 할당합니다. (SqlSmoObject에서 상속됨) |
|
GetDateTimeParameter | SqlSmoObject 의 datetime 속성을 할당합니다. (SqlSmoObject에서 상속됨) |
|
GetDateTimeParameterAsInt | datetime 속성이 Null이 아닐 경우 SqlSmoObject의 datetime 속성을 정수 값으로 지정합니다. (SqlSmoObject에서 상속됨) |
|
GetDBName | 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. Gets the database name that is associated with the object. (AgentObjectBase에서 상속됨) |
|
GetEnumParameter | SqlSmoObject 의 열거 속성을 할당합니다. (SqlSmoObject에서 상속됨) |
|
GetFragOptionString | FragmentationOption 개체를 문자열 값으로 가져옵니다. (SqlSmoObject에서 상속됨) |
|
GetGuidParameter | SqlSmoObject 의 Guid 속성을 할당합니다. (SqlSmoObject에서 상속됨) |
|
GetHashCode | (Object에서 상속됨) |
|
GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | SqlSmoObject 의 매개 변수를 할당합니다. (SqlSmoObject에서 상속됨) |
|
GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | SqlSmoObject 의 매개 변수를 할당합니다. (SqlSmoObject에서 상속됨) |
|
GetPropValue | SqlSmoObject 개체의 속성 값을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
GetPropValueOptional | SqlSmoObject 개체의 속성 값을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
GetPropValueOptionalAllowNull | SqlSmoObject 개체의 속성 값을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
GetRealValue | SqlSmoObject 개체의 속성 값을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
GetScriptingOptionsForCreate | SqlSmoObject 개체에 대한 ScriptingOptions를 가져옵니다. (SqlSmoObject에서 상속됨) |
|
GetServerName | 개체에 연결된 SQL Server 인스턴스의 이름을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
GetServerObject | SqlSmoObject 개체의 서버를 가져옵니다. (SqlSmoObject에서 상속됨) |
|
GetSqlServerVersionName | 개체에 연결된 SQL Server 인스턴스의 버전을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | SqlSmoObject 개체의 문자열 매개 변수를 할당합니다. (SqlSmoObject에서 상속됨) |
|
GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | SqlSmoObject 개체의 문자열 매개 변수를 할당합니다. (SqlSmoObject에서 상속됨) |
|
GetTimeSpanParameterAsInt | SqlSmoObject 개체의 시간 범위 매개 변수를 할당합니다. (SqlSmoObject에서 상속됨) |
|
GetType | (Object에서 상속됨) |
|
GetUrnRecursive(StringBuilder) | SqlSmoObject 개체의 Urn 개체를 할당합니다. (SqlSmoObject에서 상속됨) |
|
GetUrnRecursive(StringBuilder, UrnIdOption) | SqlSmoObject 개체의 Urn 개체를 할당합니다. (SqlSmoObject에서 상속됨) |
|
ImplInitialize | SqlSmoObject 개체의 필드를 초기화합니다. (SqlSmoObject에서 상속됨) |
|
Initialize() () () () | 개체를 초기화하고 속성을 강제로 로드합니다. (SqlSmoObject에서 상속됨) |
|
Initialize(Boolean) | 개체를 초기화하고 속성을 강제로 로드합니다. (SqlSmoObject에서 상속됨) |
|
IsObjectDirty | 개체 속성이 수정되었고 변경 내용이 SQL Server 인스턴스에서 아직 유지되는지 여부를 검사합니다. (SqlSmoObject에서 상속됨) |
|
IsObjectInitialized | 개체가 초기화되었는지 여부를 검사합니다. (SqlSmoObject에서 상속됨) |
|
IsObjectInSpace | 개체가 분리되는지, 아니면 SQL Server 인스턴스에 연결되는지를 검사합니다. (SqlSmoObject에서 상속됨) |
|
IsVersion80SP3 | SQL Server의 버전이 SQL Server 2000 서비스 팩 3인지 여부를 확인합니다. (SqlSmoObject에서 상속됨) |
|
IsVersion90AndAbove | SQL Server의 버전이 SQL Server 2005 이상인지 여부를 확인합니다. (SqlSmoObject에서 상속됨) |
|
MarkDropped | SqlSmoState 를 dropped로 설정합니다. (SqlSmoObject에서 상속됨) |
|
MarkForDropImpl | SqlSmoState 를 dropped로 설정합니다. (SqlSmoObject에서 상속됨) |
|
MemberwiseClone | (Object에서 상속됨) |
|
PostAlter | SqlSmoObject 가 변경된 후 활성화된 메서드입니다. (SqlSmoObject에서 상속됨) |
|
PostCreate | SqlSmoObject 가 생성된 후 활성화된 메서드입니다. (SqlSmoObject에서 상속됨) |
|
PostDrop | SqlSmoObject 가 삭제된 후 활성화된 메서드입니다. (SqlSmoObject에서 상속됨) |
|
Refresh | 개체를 새로 고치고 다음에 개체에 액세스할 때 속성을 검색합니다. (SqlSmoObject에서 상속됨) |
|
Rename | Renames the job step. |
|
RenameImpl | 정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다. (NamedSmoObject에서 상속됨) |
|
RenameImplWorker | 정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다. (NamedSmoObject에서 상속됨) |
|
Script() () () () | Generates a Transact-SQL script that can be used to re-create the Microsoft SQL Server Agent job step. |
|
Script(ScriptingOptions) | Generates a Transact-SQL script that can be used to re-create the Microsoft SQL Server Agent job step as specified by the scripting options. |
|
ScriptAlter | 매개 변수에 따라 SqlSmoObject를 변경합니다. (SqlSmoObject에서 상속됨) |
|
ScriptChangeOwner | This method supports the SMO infrastructure and is not intended to be used directly from your code. (NamedSmoObject에서 상속됨) |
|
ScriptCreate | 매개 변수에 따라 SqlSmoObject를 변경합니다. (SqlSmoObject에서 상속됨) |
|
ScriptDdl | InvalidSmoOperationException 을 발생합니다. (SqlSmoObject에서 상속됨) |
|
ScriptDrop | InvalidSmoOperationException 을 발생합니다. (SqlSmoObject에서 상속됨) |
|
ScriptImpl() () () () | SqlSmoObject 의 스크립트 컬렉션을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
ScriptImpl(ScriptingOptions) | SqlSmoObject 의 스크립트 컬렉션을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
ScriptImplWorker | SqlSmoObject 의 스크립트 컬렉션을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
ScriptOwner | Alters the script owner authorization. (NamedSmoObject에서 상속됨) |
|
ScriptRename | This method supports the SMO infrastructure and is not intended to be used directly from your code. (NamedSmoObject에서 상속됨) |
|
SetParentImpl | SqlSmoObject 의 부모를 newParent 매개 변수로 설정합니다. (SqlSmoObject에서 상속됨) |
|
SetSchemaOwned | Sets the schema owned value. (NamedSmoObject에서 상속됨) |
|
ToString | 참조된 개체를 나타내는 String을 반환합니다. (SqlSmoObject에서 상속됨) |
|
TouchImpl | 구현되지 않았습니다. (SqlSmoObject에서 상속됨) |
|
UnbindDefaultImpl | SqlSmoObject 의 기본 열을 바인딩 해제합니다. (SqlSmoObject에서 상속됨) |
|
UnbindRuleImpl | SqlSmoObject 의 규칙을 바인딩 해제합니다. (SqlSmoObject에서 상속됨) |
|
Validate | Validates the state of an object. (SmoObjectBase에서 상속됨) |
맨 위로 이동
이벤트
| 이름 | 설명 | |
|---|---|---|
.gif "공용 이벤트") |
PropertyChanged | 속성이 변경될 때 발생하는 이벤트를 나타냅니다. (SqlSmoObject에서 상속됨) |
|
PropertyMetadataChanged | 속성 메타데이터가 변경될 때 발생하는 이벤트를 나타냅니다. (SqlSmoObject에서 상속됨) |
맨 위로 이동
필드
| 이름 | 설명 | |
|---|---|---|
.gif "보호된 필드") |
m_ExtendedProperties | SqlSmoObject 에서 제공하는 속성을 확장하도록 정의된 속성을 나타냅니다. (SqlSmoObject에서 상속됨) |
|
singletonParent | 단일 부모를 나타냅니다. (SqlSmoObject에서 상속됨) |
맨 위로 이동
명시적 인터페이스 구현
| 이름 | 설명 | |
|---|---|---|
.gif "명시적 인터페이스 구현") .gif "전용 메서드") |
IAlienObject. . :: . .Discover | 모든 종속성을 검색합니다. 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SqlSmoObject에서 상속됨) |
|
IAlienObject. . :: . .GetDomainRoot | 도메인의 루트를 반환합니다. (SqlSmoObject에서 상속됨) |
|
IAlienObject. . :: . .GetParent | 이 개체의 부모를 가져옵니다. 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SqlSmoObject에서 상속됨) |
|
IAlienObject. . :: . .GetPropertyType | 지정한 속성의 유형을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
IAlienObject. . :: . .GetPropertyValue | 지정한 속성의 값을 가져옵니다. (SqlSmoObject에서 상속됨) |
|
IAlienObject. . :: . .GetUrn | 개체의 URN(Unified Resource Name)을 가져옵니다. 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SqlSmoObject에서 상속됨) |
|
IAlienObject. . :: . .Resolve | 개체의 URN(Unified Resource Name)에서 개체에 대한 정보를 포함하는 인스턴스를 가져옵니다. (SqlSmoObject에서 상속됨) |
|
IAlienObject. . :: . .SetObjectState | 개체 상태를 지정한 SfcObjectState 값으로 설정합니다. (SqlSmoObject에서 상속됨) |
|
IAlienObject. . :: . .SetPropertyValue | 속성 값을 설정합니다. (SqlSmoObject에서 상속됨) |
|
ISfcPropertyProvider. . :: . .GetPropertySet | 이 개체의 속성 집합에 대한 인터페이스 참조를 가져옵니다. 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SqlSmoObject에서 상속됨) |
맨 위로 이동
주의
SQL Server Agent jobs contain one or more execution units called steps. Each job step contains a textual command, type of execution that specifies command interpretation, and logic that determines the behavior of the job if the step succeeds or fails. For example, a job step can contain:
The command text. For example:
DBCC CHECKDB ('Northwind') WITH NO_INFOMSGSA job step execution type: Transact-SQL for example.
An indication that the job should stop if the step fails.
With the JobStep object, you can do the following:
Create a SQL Server Agent job step.
Remove a job step from a SQL Server Agent job.
Manage existing job steps by changing, for example, the command text or the actions taken on success or failure of the step.
Obtain details about the last attempted execution of the step.
To get JobStep object properties, users must be a member of SQLAgentUserRole database role on the MSDB database or be a member of the sysadmin fixed server role.
To set JobStep object properties, users must be a member of SQLAgentUserRole database role on the MSDB database, be the owner of the owner of the job step, or be a member of the sysadmin fixed server role.
To create a job step, users must be a member of SQLAgentUserRole database role on the MSDB database or be a member of the sysadmin fixed server role. The user must also have permission on any proxy accounts used by the job step.
To drop a job step, users must be a member of SQLAgentUserRole database role on the MSDB database, be the owner of the job step, or be a member of the sysadmin fixed server role.
Thread Safety
이 유형의 모든 public static(Microsoft Visual Basic의 경우 공유) 멤버는 다중 스레드 작업을 수행하기에 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.
스레드 보안
이 유형의 모든 공용 static(Visual Basic에서는 Shared) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.