ProxyAccount 클래스

The ProxyAccount class represents a SQL Server Agent proxy account.

상속 계층

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..::..ProxyAccount

네임스페이스:  Microsoft.SqlServer.Management.Smo.Agent
어셈블리:  Microsoft.SqlServer.Smo(Microsoft.SqlServer.Smo.dll)

구문

‘선언
Public NotInheritable Class ProxyAccount _
    Inherits AgentObjectBase _
    Implements IAlterable, ICreatable, IDroppable, IRenamable,  _
    IScriptable
‘사용 방법
Dim instance As ProxyAccount

public sealed class ProxyAccount : AgentObjectBase, 
    IAlterable, ICreatable, IDroppable, IRenamable, IScriptable

public ref class ProxyAccount sealed : public AgentObjectBase, 
    IAlterable, ICreatable, IDroppable, IRenamable, IScriptable

[<SealedAttribute>]
type ProxyAccount =  
    class
        inherit AgentObjectBase
        interface IAlterable
        interface ICreatable
        interface IDroppable
        interface IRenamable
        interface IScriptable
    end

public final class ProxyAccount extends AgentObjectBase implements IAlterable, ICreatable, IDroppable, IRenamable, IScriptable

ProxyAccount 유형에서 다음 멤버를 표시합니다.

생성자

	이름	설명
	ProxyAccount() () () ()	Initializes a new instance of the ProxyAccount class.
	ProxyAccount(JobServer, String)	Initializes a new instance of the ProxyAccount class on the specified SQL Server Agent Service, with the specified name.
	ProxyAccount(JobServer, String, String)	Initializes a new instance of the ProxyAccount class on the specified SQL Server Agent Service with the specified name and credential.
	ProxyAccount(JobServer, String, String, Boolean)	Initializes a new instance of the ProxyAccount class on the specified SQL Server Agent Service with the specified name and credential. It also specifies whether the proxy account is enabled.
	ProxyAccount(JobServer, String, String, Boolean, String)	Initializes a new instance of the ProxyAccount class on the specified SQL Server Agent Service with the specified name and credential. It also specifies whether the proxy account is enabled.

맨 위로 이동

속성

	이름	설명
	CredentialID	Gets the ID value that uniquely identifies the proxy agent credential.
	CredentialIdentity	Gets the credential identity.
	CredentialName	Gets or sets the name of the credential.
	Description	Gets or sets a textual description of the proxy account.
	ExecuteForScalar	스칼라 옵션을 실행하도록 개체를 설정할지 여부를 지정하는 Boolean 속성 값을 가져오거나 설정합니다. (SqlSmoObject에서 상속됨)
	ID	Gets the ID value that uniquely identifies the proxy account.
	IsEnabled	Gets or sets the Boolean property value that specifies whether the proxy account is enabled or not.
	IsTouched	개체 속성이 업데이트되었으나 아직 서버에 유지되는지 여부를 지정하는 Boolean 속성 값을 가져옵니다. (SqlSmoObject에서 상속됨)
	Name	Gets or sets the name of the object. (NamedSmoObject에서 상속됨)
	ObjectInSpace	개체가 분리되어 존재하는지, 아니면 SQL Server 인스턴스에 직접 또는 간접 연결되는지를 지정하는 Boolean 속성 값을 가져옵니다. (SqlSmoObject에서 상속됨)
	Parent	Gets or sets the JobServer object that is the parent of the ProxyAccount object.
	Properties	개체 속성을 나타내는 Property 개체의 컬렉션을 가져옵니다. (SqlSmoObject에서 상속됨)
	ScalarResult	참조된 개체의 스칼라 결과를 가져옵니다. (SqlSmoObject에서 상속됨)
	State	Gets the state of the referenced object. (SmoObjectBase에서 상속됨)
	Urn	개체를 고유하게 식별하는 URN(Uniform Resource Name) 주소 값을 가져옵니다. (SqlSmoObject에서 상속됨)
	UserData	Gets or sets user-defined data associated with the referenced object. (SmoObjectBase에서 상속됨)

맨 위로 이동

메서드

	이름	설명
	AddDatabaseContext(StringCollection)	queries 매개 변수로 식별되는 쿼리 컬렉션에 데이터베이스 컨텍스트를 추가합니다. (SqlSmoObject에서 상속됨)
	AddDatabaseContext(StringCollection, ScriptingOptions)	queries 매개 변수로 식별되는 쿼리 컬렉션에 지정한 스크립팅 옵션을 사용하여 데이터베이스 컨텍스트를 추가합니다. (SqlSmoObject에서 상속됨)
	AddLogin	Adds a Microsoft Windows login account to the proxy account.
	AddMsdbRole	Adds a Microsoft SQL Server database role to the proxy account.
	AddServerRole	Adds a Microsoft SQL Server server role to the proxy account.
	AddSubSystem	Adds a Microsoft SQL Server subsystem to the proxy account.
	Alter	Updates any ProxyAccount object property changes on an 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 on the instance of Microsoft SQL Server as defined by the ProxyAccount object.
	CreateImpl	스크립팅 옵션을 사용하여 개체를 만듭니다. (SqlSmoObject에서 상속됨)
	CreateImplFinish	만들기 이벤트가 완료되면 호출되는 메서드입니다. (SqlSmoObject에서 상속됨)
	CreateImplInit	만들기 이벤트가 초기화되면 호출되는 메서드입니다. (SqlSmoObject에서 상속됨)
	Discover	Object 유형의 목록을 검색합니다. (SqlSmoObject에서 상속됨)
	Drop	Removes an existing proxy account.
	DropImpl	SqlSmoObject 를 삭제합니다. (SqlSmoObject에서 상속됨)
	DropImplWorker	삭제 메서드를 호출합니다. (SqlSmoObject에서 상속됨)
	EnumLogins	Enumerates a list of Microsoft Windows login accounts associated with the referenced proxy account.
	EnumMsdbRoles	Enumerates a list of Microsoft SQL Server database roles associated with the referenced proxy account.
	EnumScriptImpl	so 매개 변수로 지정한 스크립트를 열거합니다. (SqlSmoObject에서 상속됨)
	EnumScriptImplWorker	so 매개 변수로 지정한 스크립트를 열거하는 메서드를 호출합니다. (SqlSmoObject에서 상속됨)
	EnumScriptImplWorkerSOChanged	개체의 스크립팅 옵션을 설명하는 IEnumerable 문자열을 반환합니다. (SqlSmoObject에서 상속됨)
	EnumServerRoles	Enumerates a list of Microsoft SQL Server server roles associated with the referenced proxy account.
	EnumSubSystems	Enumerates a list of Microsoft SQL Server subsystems associated with the referenced proxy account.
	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에서 상속됨)
	RemoveLogin	Removes a Microsoft Windows login account from the referenced proxy account.
	RemoveMsdbRole	Removes a Microsoft SQL Server database role from the referenced proxy account.
	RemoveServerRole	Removes a Microsoft SQL Server server role from the referenced proxy account.
	RemoveSubSystem	Removes a Microsoft SQL Server subsystem from the referenced proxy account.
	Rename	Renames a proxy account.
	RenameImpl	정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다. (NamedSmoObject에서 상속됨)
	RenameImplWorker	정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다. (NamedSmoObject에서 상속됨)
	Script() () () ()	Generates a Transact-SQL script that can be used to re-create the SQL Server Agent proxy account.
	Script(ScriptingOptions)	Generates a Transact-SQL script that can be used to re-create the SQL Server Agent proxy account 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에서 상속됨)

맨 위로 이동

이벤트

	이름	설명
	PropertyChanged	속성이 변경될 때 발생하는 이벤트를 나타냅니다. (SqlSmoObject에서 상속됨)
	PropertyMetadataChanged	속성 메타데이터가 변경될 때 발생하는 이벤트를 나타냅니다. (SqlSmoObject에서 상속됨)

맨 위로 이동

필드

	이름	설명
	m_ExtendedProperties	SqlSmoObject 에서 제공하는 속성을 확장하도록 정의된 속성을 나타냅니다. (SqlSmoObject에서 상속됨)
	singletonParent	단일 부모를 나타냅니다. (SqlSmoObject에서 상속됨)

맨 위로 이동

명시적 인터페이스 구현

	이름	설명
	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에서 상속됨)

맨 위로 이동

주의

Proxy accounts allow for the impersonation of logins, server roles, and database roles when executing a job step in any subsystem other than Transact-SQL. In SQL Server Management Objects (SMO), the ProxyAccount object allows programmatic control over proxy accounts. The ProxyAccount object describes the relationship between an alternative (proxy) login account, a subsystem that is used for job step execution, and a list of Microsoft SQL Server logins, server roles, and database roles.

To get ProxyAccount object properties, users must be a member of the SQLAgentOperatorRole on the MSDB database, or be a member of the sysadmin fixed server role.

To set ProxyAccount object properties, users must be a member of the sysadmin fixed server role.

To create or drop a proxy account, users must be a member of the sysadmin fixed server role.

To add or remove subsystems from the proxy account, users must be a member of the sysadmin fixed server role.

Thread Safety

이 유형의 모든 public static(Microsoft Visual Basic의 경우 공유) 멤버는 다중 스레드 작업을 수행하기에 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.

예

SQL Server 에이전트에서 자동 관리 태스크 예약

스레드 보안

이 유형의 모든 공용 static(Visual Basic에서는 Shared) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.

참고 항목

참조

Microsoft.SqlServer.Management.Smo.Agent 네임스페이스

관련 자료

SQL Server 에이전트에서 자동 관리 태스크 예약

관리 태스크 자동화(SQL Server 에이전트)

sp_add_proxy(Transact-SQL)

sp_grant_proxy_to_subsystem(Transact-SQL)