Condividi tramite


Classe Login

The Login object represents a SQL Server login account that has been granted access to the instance of SQL Server through Windows Authentication or SQL Server Authentication.

Gerarchia di ereditarietà

System.Object
  Microsoft.SqlServer.Management.Smo.SmoObjectBase
    Microsoft.SqlServer.Management.Smo.SqlSmoObject
      Microsoft.SqlServer.Management.Smo.NamedSmoObject
        Microsoft.SqlServer.Management.Smo.ScriptNameObjectBase
          Microsoft.SqlServer.Management.Smo.Login

Spazio dei nomi  Microsoft.SqlServer.Management.Smo
Assembly:  Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)

Sintassi

'Dichiarazione
<PhysicalFacetAttribute> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class Login _
    Inherits ScriptNameObjectBase _
    Implements ISfcSupportsDesignMode, IObjectPermission, ICreatable, IAlterable,  _
    IDroppable, IRenamable, IScriptable, ILoginOptions, IDmfFacet
'Utilizzo
Dim instance As Login
[PhysicalFacetAttribute]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)]
public sealed class Login : ScriptNameObjectBase, 
    ISfcSupportsDesignMode, IObjectPermission, ICreatable, IAlterable, IDroppable, 
    IRenamable, IScriptable, ILoginOptions, IDmfFacet
[PhysicalFacetAttribute]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode::CheckOnSchedule)]
public ref class Login sealed : public ScriptNameObjectBase, 
    ISfcSupportsDesignMode, IObjectPermission, ICreatable, IAlterable, IDroppable, 
    IRenamable, IScriptable, ILoginOptions, IDmfFacet
[<SealedAttribute>]
[<PhysicalFacetAttribute>]
[<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)>]
type Login =  
    class 
        inherit ScriptNameObjectBase 
        interface ISfcSupportsDesignMode 
        interface IObjectPermission 
        interface ICreatable 
        interface IAlterable 
        interface IDroppable 
        interface IRenamable 
        interface IScriptable 
        interface ILoginOptions 
        interface IDmfFacet 
    end
public final class Login extends ScriptNameObjectBase implements ISfcSupportsDesignMode, IObjectPermission, ICreatable, IAlterable, IDroppable, IRenamable, IScriptable, ILoginOptions, IDmfFacet

Nel tipo Login sono esposti i membri seguenti.

Costruttori

  Nome Descrizione
Metodo pubblico Login() Initializes a new instance of the Login class.
Metodo pubblico Login(Server, String) Initializes a new instance of the Login class on the specified instance of SQL Server and with the specified name.

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica AsymmetricKey Gets the asymmetric key associated with the login.
Proprietà pubblica Certificate Gets the certificate associated with the login.
Proprietà pubblica CreateDate Gets the date and time when the login account was created.
Proprietà pubblica Credential Gets the credential associated with the login.
Proprietà pubblica DateLastModified Gets the date and time when the login account was last modified.
Proprietà pubblica DefaultDatabase Gets or sets the default database that the login account is assigned to after logging on to the instance of SQL Server.
Proprietà pubblica DenyWindowsLogin Gets or sets the Boolean property value that specifies whether the login account has been granted or denied the ability to log on to the instance of SQL Server.
Proprietà pubblica Events Gets the events associated with the login account.
Proprietà pubblica HasAccess Gets or sets the Boolean property value that specifies whether the SQL Server login account has access to the instance of SQL Server.
Proprietà pubblica ID Gets the ID value that uniquely identifies the login account.
Proprietà pubblica IsDisabled Gets or sets the Boolean property value that specifies whether the SQL Server login account is disabled.
Proprietà pubblica IsLocked Gets the Boolean property value that specifies whether the login account has been locked out of the instance of SQL Server.
Proprietà pubblica IsPasswordExpired Gets the Boolean property value that specifies whether the password for the SQL Server login account has expired.
Proprietà pubblica IsSystemObject Gets or sets the Boolean property value that specifies whether the SQL Server login account is a system object.
Proprietà pubblica Language Gets or sets the language required by the referenced login account for date formats and system messages.
Proprietà pubblica LanguageAlias Gets the alias name used for the language that is required by the SQL Server login account.
Proprietà pubblica LoginType Gets or sets the type of SQL Server login account.
Proprietà pubblica MustChangePassword Gets the Boolean property value that specifies whether the login account password must be changed when the user next logs on to the instance of SQL Server.
Proprietà pubblica Name Gets or sets the name of the login. Esegue l'override di NamedSmoObject.Name.
Proprietà pubblica Parent Gets the Server object that is the parent of the Login object.
Proprietà pubblica PasswordExpirationEnabled Gets the Boolean property value that specifies whether the password for the login account will automatically expire.
Proprietà pubblica PasswordHashAlgorithm Gets or sets the hash algorithm used for the password.
Proprietà pubblica PasswordPolicyEnforced Gets the Boolean property value that specifies whether password policy is enforced for this login account.
Proprietà pubblica Properties Gets a collection of Property objects that represent the object properties. Ereditato da SqlSmoObject.
Proprietà pubblica Sid Gets or sets the security identifier (SID) for the login account.
Proprietà pubblica State Gets the state of the referenced object. Ereditato da SmoObjectBase.
Proprietà pubblica Urn Gets the Uniform Resource Name (URN) address value that uniquely identifies the object. Ereditato da SqlSmoObject.
Proprietà pubblica UserData Gets or sets user-defined data associated with the referenced object. Ereditato da SmoObjectBase.
Proprietà pubblica WindowsLoginAccessType Gets the type of Windows logon access.

In alto

Metodi

  Nome Descrizione
Metodo pubblico AddCredential Adds a login credential.
Metodo pubblico AddToRole Adds the login account to a SQL Server role.
Metodo pubblico Alter Updates any Login object property changes on the login account on the instance of SQL Server.
Metodo pubblico ChangePassword(String) Changes the password for the login account.
Metodo pubblico ChangePassword(String, String) Changes the password for the login account.
Metodo pubblico ChangePassword(String, Boolean, Boolean) Changes the password for the login account.
Metodo pubblico Create() Creates a login account on the instance of SQL Server as defined by the Login object.
Metodo pubblico Create(SecureString) Creates a login account on the instance of SQL Server as defined by the Login object.
Metodo pubblico Create(String) Creates a login account on the instance of SQL Server as defined by the Login object.
Metodo pubblico Create(SecureString, LoginCreateOptions) Creates a login account on the instance of SQL Server as defined by the Login object.
Metodo pubblico Create(String, LoginCreateOptions) Creates a login account on the instance of SQL Server as defined by the Login object.
Metodo pubblico Deny(ObjectPermissionSet, String) Denies the specified set of permissions for the specified grantee on the login account.
Metodo pubblico Deny(ObjectPermissionSet, array<String[]) Denies the specified set of permissions for the specified grantees on the logon.
Metodo pubblico Deny(ObjectPermissionSet, String, Boolean) Denies the specified set of permissions for the specified grantee and other users that the grantee granted the specified set of permissions on the logon.
Metodo pubblico Deny(ObjectPermissionSet, array<String[], Boolean) Denies the specified set of permissions for the specified grantees and other users that the grantee granted the specified set of permissions on the logon.
Metodo pubblico Disable Disables the login account.
Metodo pubblico Discover Discovers a list of type Object. Ereditato da SqlSmoObject.
Metodo pubblico Drop Removes the login account from the instance of SQL Server.
Metodo pubblico DropCredential Drops a login credential.
Metodo pubblico Enable Enables the login account.
Metodo pubblico EnumAgentProxyAccounts Enumerates a list of agent proxy accounts in which the login account is participating.
Metodo pubblico EnumCredentials Returns a string collection of credentials associated with a login.
Metodo pubblico EnumDatabaseMappings Enumerates a list of login account mappings to databases and database users.
Metodo pubblico EnumObjectPermissions() Enumerates a list of object permissions for the login account.
Metodo pubblico EnumObjectPermissions(String) Enumerates a list of object permissions for a specified grantee on the login account.
Metodo pubblico EnumObjectPermissions(ObjectPermissionSet) Enumerates a list of object permissions for a specified permission on the login account.
Metodo pubblico EnumObjectPermissions(String, ObjectPermissionSet) Enumerates a list of object permissions for a specified grantee and a specified permission on the login account.
Metodo pubblico Equals Ereditato da Object.
Metodo protetto FormatSqlVariant Formats an object as SqlVariant type. Ereditato da SqlSmoObject.
Metodo protetto GetContextDB Gets the context database that is associated with this object. Ereditato da SqlSmoObject.
Metodo pubblico GetDatabaseUser Gets the name of the user that the login account is mapped to in a specified database.
Metodo protetto GetDBName Gets the database name that is associated with the object. Ereditato da SqlSmoObject.
Metodo pubblico GetHashCode Ereditato da Object.
Metodo protetto GetPropValue Gets a property value of the SqlSmoObject object. Ereditato da SqlSmoObject.
Metodo protetto GetPropValueOptional Gets a property value of the SqlSmoObject object. Ereditato da SqlSmoObject.
Metodo protetto GetPropValueOptionalAllowNull Gets a property value of the SqlSmoObject object. Ereditato da SqlSmoObject.
Metodo protetto GetServerObject Gets the server of the SqlSmoObject object. Ereditato da SqlSmoObject.
Metodo pubblico GetType Ereditato da Object.
Metodo pubblico Grant(ObjectPermissionSet, String) Grants the specified set of permissions to the specified grantee on the login account.
Metodo pubblico Grant(ObjectPermissionSet, array<String[]) Grants the specified set of permissions to the specified grantees on the login account.
Metodo pubblico Grant(ObjectPermissionSet, String, Boolean) Grants access to the specified permission to the grantee and the ability to grant access to other users on the login account.
Metodo pubblico Grant(ObjectPermissionSet, array<String[], Boolean) Grants access to the specified permission to the grantees and the ability to grant access to other users on the login account.
Metodo pubblico Grant(ObjectPermissionSet, String, Boolean, String) Grants the specified set of permissions to the grantee and the ability to grant the set of permissions to other users on the login account under an assumed role.
Metodo pubblico Grant(ObjectPermissionSet, array<String[], Boolean, String) Grants the specified set of permissions to the grantees and the ability to grant the set of permissions to other users on the logon under an assumed role.
Metodo pubblico Initialize() Initializes the object and forces the properties be loaded. Ereditato da SqlSmoObject.
Metodo pubblico Initialize(Boolean) Initializes the object and forces the properties be loaded. Ereditato da SqlSmoObject.
Metodo pubblico IsMember Returns a Boolean value that specifies whether the login account is a member of a specified role.
Metodo protetto IsObjectInitialized Verifies whether the object has been initialized. Ereditato da SqlSmoObject.
Metodo protetto IsObjectInSpace Verifies whether the object is isolated or connected to the instance of SQL Server. Ereditato da SqlSmoObject.
Metodo pubblico ListMembers Returns a list of the roles of which the login account is a member.
Metodo pubblico Refresh Refreshes the login credentials. Esegue l'override di ScriptNameObjectBase.Refresh().
Metodo pubblico Rename Renames the login account.
Metodo pubblico Revoke(ObjectPermissionSet, String) Revokes a previously granted set of permissions from a grantee on the login account.
Metodo pubblico Revoke(ObjectPermissionSet, array<String[]) Revokes a previously granted set of permissions from a list of grantees on the login account.
Metodo pubblico Revoke(ObjectPermissionSet, String, Boolean, Boolean) Revokes previously granted permissions from a grantee on the login account and any other users to whom the grantee has granted the specified set of permissions. The grantee is also given the ability to revoke the specified set of permissions from other users under an assumed role.
Metodo pubblico Revoke(ObjectPermissionSet, array<String[], Boolean, Boolean) Revokes previously granted permissions from grantees on the login account and any other users to whom the grantees have granted the specified set of permissions. The grantees are also given the ability to revoke the specified set of permissions from other users under an assumed role.
Metodo pubblico Revoke(ObjectPermissionSet, String, Boolean, Boolean, String) Revokes previously granted permissions from a grantee on the login account and any other users to whom the grantee has granted the specified set of permissions. The grantee is also given the ability to revoke the specified set of permissions from other users under an assumed role.
Metodo pubblico Revoke(ObjectPermissionSet, array<String[], Boolean, Boolean, String) Revokes previously granted permissions from grantees on the login account and any other users to whom the grantees have granted the specified set of permissions. The grantees are also given the ability to revoke the specified set of permissions from other users under an assumed role.
Metodo pubblico Script() Generates a Transact-SQL script that can be used to re-create the login account.
Metodo pubblico Script(ScriptingOptions) Generates a Transact-SQL script that can be used to re-create the login account as specified by the script options.
Metodo protetto SetParentImpl Sets the parent of the SqlSmoObject to the newParent parameter. Ereditato da SqlSmoObject.
Metodo pubblico ToString Returns a String that represents the referenced object. Ereditato da SqlSmoObject.
Metodo pubblico Validate Validates the state of an object. Ereditato da SmoObjectBase.

In alto

Eventi

  Nome Descrizione
Evento pubblico PropertyChanged Represents the event that occurs when a property is changed. Ereditato da SqlSmoObject.
Evento pubblico PropertyMetadataChanged Represents the event that occurs when property metadata changes. Ereditato da SqlSmoObject.

In alto

Implementazioni esplicite dell'interfaccia

  Nome Descrizione
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject.Discover Discovers any dependencies. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject.GetDomainRoot Returns the root of the domain. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject.GetParent Gets the parent of this object. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject.GetPropertyType Gets the type of the specified property. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject.GetPropertyValue Gets the value of the specified property. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject.GetUrn Gets the Unified Resource Name (URN) of the object. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject.Resolve Gets the instance that contains the information about the object from the Unified Resource Name (URN) of the object. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject.SetObjectState Sets the object state to the specified SfcObjectState value. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject.SetPropertyValue Sets the property value. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato ISfcPropertyProvider.GetPropertySet Gets the interface reference to the set of properties of this object. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaProprietà privata ISfcSupportsDesignMode.IsDesignMode Gets a Boolean value that indicates whether the object supports design mode. Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.

In alto

Osservazioni

To get Login object properties, users can be a member of the public fixed server role.

To set Login object properties, users must have ALTER ANY LOGIN permissions on the server or be a member of the sysadmin fixed server role.

To create or drop a login, users must have ALTER ANY LOGIN permissions on the server or be a member of the sysadmin fixed server role.

To grant, deny, or revoke permission on the login to other users, users must have CONTROL permissions on the logon or be a member of the sysadmin or securityadmin fixed server roles.

To set the password on a login without providing an old password, users must be a member of the sysadmin fixed server role.

Thread Safety

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono sicuri per le operazioni a thread multipli. Non è invece garantita la sicurezza dei membri dell'istanza.

Esempi

Gestione di utenti, ruoli e account di accesso

Protezione dei thread

I membri static (Shared in Visual Basic) pubblici di questo tipo sono affidabili. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Spazio dei nomi Microsoft.SqlServer.Management.Smo

Altre risorse

Entità (Motore di database)

CREATE LOGIN (Transact-SQL)