Delen via


ALTER LOGIN (Transact-SQL)

Hiermee wijzigt u de eigenschappen van een SQL Server-aanmeldingsaccount.

Transact-SQL syntaxisconventies

Notitie

Microsoft Entra ID voorheen Azure Active Directory (Azure AD) werd genoemd.

Een product selecteren

Selecteer in de volgende rij de productnaam waarin u geïnteresseerd bent en alleen de informatie van dat product wordt weergegeven.

* SQL Server *  

 

SQL Server

Syntaxis voor SQL Server

ALTER LOGIN login_name
    {
    <status_option>
    | WITH <set_option> [ , ... ]
    | <cryptographic_credential_option>
    }
[;]

<status_option> ::=
        ENABLE | DISABLE

<set_option> ::=
    PASSWORD = 'password' | hashed_password HASHED
    [
      OLD_PASSWORD = 'oldpassword'
      | <password_option> [ <password_option> ]
    ]
    | DEFAULT_DATABASE = database
    | DEFAULT_LANGUAGE = language
    | NAME = login_name
    | CHECK_POLICY = { ON | OFF }
    | CHECK_EXPIRATION = { ON | OFF }
    | CREDENTIAL = credential_name
    | NO CREDENTIAL

<password_option> ::=
    MUST_CHANGE | UNLOCK

<cryptographic_credentials_option> ::=
    ADD CREDENTIAL credential_name
  | DROP CREDENTIAL credential_name

Argumenten

login_name

Hiermee geeft u de naam op van de SQL Server-aanmelding die wordt gewijzigd. Domeinaanmelding moet tussen vierkante haken staan in de indeling [<domain>\<user>].

INSCHAKELEN | UITSCHAKELEN

Hiermee schakelt u deze aanmelding in of uit. Het uitschakelen van een aanmelding heeft geen invloed op het gedrag van aanmeldingen die al zijn verbonden. (Gebruik de instructie KILL om een bestaande verbinding te beëindigen.) Uitgeschakelde aanmeldingen behouden hun machtigingen en kunnen nog steeds worden geïmiteerd.

PASSWORD = 'wachtwoord'

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u het wachtwoord op voor de aanmelding die wordt gewijzigd. Wachtwoorden zijn hoofdlettergevoelig.

PASSWORD = hashed_password

Alleen van toepassing op het trefwoord HASHED. Hiermee geeft u de gehashte waarde van het wachtwoord voor de aanmelding die wordt gemaakt.

Belangrijk

Wanneer een aanmelding (of een ingesloten databasegebruiker) verbinding maakt en wordt geverifieerd, slaat de verbinding identiteitsgegevens over de aanmelding in de cache op. Voor aanmelding bij Windows-verificatie bevat dit informatie over lidmaatschap van Windows-groepen. De identiteit van de aanmelding blijft geverifieerd zolang de verbinding behouden blijft. Als u wijzigingen in de identiteit wilt afdwingen, zoals het opnieuw instellen van een wachtwoord of wijziging in het windows-groepslidmaatschap, moet de aanmelding zich afmelden bij de verificatie-instantie (Windows of SQL Server) en u opnieuw aanmelden. Een lid van de sysadmin vaste serverfunctie of een aanmelding met de ALTER ANY CONNECTION machtiging kan de KILL opdracht gebruiken om een verbinding te beëindigen en een aanmelding afdwingen om opnieuw verbinding te maken. SQL Server Management Studio kan verbindingsgegevens hergebruiken bij het openen van meerdere verbindingen met Objectverkenner en Query-editorvensters. Sluit alle verbindingen om opnieuw verbinding te maken.

HASHED

Alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u op dat het wachtwoord dat is ingevoerd nadat het argument PASSWORD al is gehasht. Als deze optie niet is geselecteerd, wordt het wachtwoord gehasht voordat het in de database wordt opgeslagen. Deze optie mag alleen worden gebruikt voor aanmeldingssynchronisatie tussen twee servers. Gebruik de optie HASHED niet om wachtwoorden regelmatig te wijzigen.

OLD_PASSWORD = 'old_password'

Is alleen van toepassing op SQL Server-aanmeldingen. Het huidige wachtwoord van de aanmelding waaraan een nieuw wachtwoord wordt toegewezen. Wachtwoorden zijn hoofdlettergevoelig.

MUST_CHANGE

Is alleen van toepassing op SQL Server-aanmeldingen. Als deze optie is opgenomen, vraagt SQL Server om een bijgewerkt wachtwoord wanneer de aanmelding voor het eerst wordt gebruikt.

DEFAULT_DATABASE = database-

Hiermee geeft u een standaarddatabase moet worden toegewezen aan de aanmelding.

DEFAULT_LANGUAGE = taal

Hiermee geeft u een standaardtaal die moet worden toegewezen aan de aanmelding. De standaardtaal voor alle SQL Database-aanmeldingen is Engels en kan niet worden gewijzigd. De standaardtaal van de sa aanmelding bij SQL Server op Linux is Engels, maar kan worden gewijzigd.

NAME = login_name

De nieuwe naam van de aanmelding waarvan de naam wordt gewijzigd. Als dit een Windows-aanmelding is, moet de SID van de Windows-principal die overeenkomt met de nieuwe naam overeenkomen met de SID die is gekoppeld aan de aanmelding in SQL Server. De nieuwe naam van een SQL Server-aanmelding mag geen backslashteken (\) bevatten.

CHECK_EXPIRATION = { AAN | UIT }

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u op of het wachtwoordverloopbeleid moet worden afgedwongen bij deze aanmelding. De standaardwaarde is UIT.

CHECK_POLICY = { ON | UIT }

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u op dat het Windows-wachtwoordbeleid van de computer waarop SQL Server wordt uitgevoerd, moet worden afgedwongen bij deze aanmelding. De standaardwaarde is AAN.

CREDENTIAL = credential_name

De naam van een referentie die moet worden toegewezen aan een SQL Server-aanmelding. De referentie moet al aanwezig zijn op de server. Zie Referentiesvoor meer informatie. Een referentie kan niet worden toegewezen aan de sa-aanmelding.

GEEN REFERENTIE

Hiermee verwijdert u alle bestaande toewijzingen van de aanmelding aan een serverreferentie. Zie Referentiesvoor meer informatie.

ONTSLUITEN

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u op dat een aanmelding die is vergrendeld, moet worden ontgrendeld.

REFERENTIE TOEVOEGEN

Hiermee voegt u een EKM-providerreferentie (Extensible Key Management) toe aan de aanmelding. Zie EKM (Extensible Key Management)voor meer informatie.

DROP CREDENTIAL

Hiermee verwijdert u een EKM-providerreferentie (Extensible Key Management) uit de aanmelding. Zie [Extensible Key Management (EKM)] (.) voor meer informatie. /.. /relational-databases/security/encryption/extensible-key-management-ekm.md).

Opmerkingen

Wanneer CHECK_POLICY is ingesteld op AAN, kan het argument HASHED niet worden gebruikt.

Wanneer CHECK_POLICY wordt gewijzigd in AAN, treedt het volgende gedrag op:

  • De wachtwoordgeschiedenis wordt geïnitialiseerd met de waarde van de huidige wachtwoord-hash.

Wanneer CHECK_POLICY wordt gewijzigd in UIT, treedt het volgende gedrag op:

  • CHECK_EXPIRATION is ook ingesteld op UIT.
  • De wachtwoordgeschiedenis is gewist.
  • De waarde van lockout_time wordt opnieuw ingesteld.

Als MUST_CHANGE is opgegeven, moeten CHECK_EXPIRATION en CHECK_POLICY worden ingesteld op AAN. Anders mislukt de instructie.

Als CHECK_POLICY is ingesteld op UIT, kan CHECK_EXPIRATION niet worden ingesteld op AAN. Een ALTER LOGIN-instructie met deze combinatie van opties mislukt.

U kunt ALTER LOGIN niet gebruiken met het argument DISABLE om de toegang tot een Windows-groep te weigeren. ALTER LOGIN [<domain>\<group>] DISABLE retourneert bijvoorbeeld het volgende foutbericht:

"Msg 15151, Level 16, State 1, Line 1
Cannot alter the login '*Domain\Group*', because it doesn't exist or you don't have permission.

Dit is standaard.

In SQL Database worden aanmeldingsgegevens die vereist zijn voor het verifiëren van een verbinding en firewallregels op serverniveau tijdelijk in de cache opgeslagen in elke database. Deze cache wordt periodiek vernieuwd. Als u een vernieuwing van de verificatiecache wilt afdwingen en ervoor wilt zorgen dat een database de nieuwste versie van de aanmeldingstabel heeft, voert u DBCC FLUSHAUTHCACHE-uit.

Machtigingen

Hiervoor is ALTER ANY LOGIN-machtiging vereist.

Als de optie CREDENTIAL wordt gebruikt, is ook ALTER ANY CREDENTIAL-machtiging vereist.

Als de aanmelding die wordt gewijzigd lid is van de sysadmin vaste serverfunctie of een grantee van CONTROL SERVER-machtiging, is ook CONTROL SERVER-machtiging vereist bij het aanbrengen van de volgende wijzigingen:

  • Het wachtwoord opnieuw instellen zonder het oude wachtwoord op te leveren.
  • MUST_CHANGE, CHECK_POLICY of CHECK_EXPIRATION inschakelen.
  • Wijzig de aanmeldingsnaam.
  • De aanmelding in- of uitschakelen.
  • De aanmelding toewijzen aan een andere referentie.

Een principal kan het wachtwoord, de standaardtaal en de standaarddatabase wijzigen voor een eigen aanmelding.

Voorbeelden

Een. Een uitgeschakelde aanmelding inschakelen

In het volgende voorbeeld wordt de aanmeldings-Mary5ingeschakeld.

ALTER LOGIN Mary5 ENABLE;

B. Het wachtwoord van een aanmelding wijzigen

In het volgende voorbeeld wordt het wachtwoord van aanmelding Mary5 gewijzigd in een sterk wachtwoord.

ALTER LOGIN Mary5 WITH PASSWORD = '<enterStrongPasswordHere>';

C. Het wachtwoord van een aanmelding wijzigen wanneer u bent aangemeld als de aanmelding

Als u het wachtwoord wilt wijzigen van de aanmelding waarmee u momenteel bent aangemeld en u niet over de machtiging ALTER ANY LOGIN beschikt, moet u de optie OLD_PASSWORD opgeven.

ALTER LOGIN Mary5 WITH PASSWORD = '<enterStrongPasswordHere>' OLD_PASSWORD = '<oldWeakPasswordHere>';

D. De naam van een aanmelding wijzigen

In het volgende voorbeeld wordt de naam van de aanmeldings-Mary5 gewijzigd in John2.

ALTER LOGIN Mary5 WITH NAME = John2;

E. Een aanmelding toewijzen aan een referentie

In het volgende voorbeeld wordt de aanmeldings-John2 toegewezen aan de referentie Custodian04.

ALTER LOGIN John2 WITH CREDENTIAL = Custodian04;

F. Een aanmelding toewijzen aan een uitbreidbare sleutelbeheerreferentie

In het volgende voorbeeld wordt de aanmeldings-Mary5 toegewezen aan de EKM-referentie EKMProvider1.

ALTER LOGIN Mary5 ADD CREDENTIAL EKMProvider1;
GO

F. Een aanmelding ontgrendelen

Als u een SQL Server-aanmelding wilt ontgrendelen, voert u de volgende instructie uit, waarbij u **** vervangt door het gewenste accountwachtwoord.

ALTER LOGIN [Mary5] WITH PASSWORD = '****' UNLOCK;
GO

Als u een aanmelding wilt ontgrendelen zonder het wachtwoord te wijzigen, schakelt u het controlebeleid uit en schakelt u het opnieuw in.

ALTER LOGIN [Mary5] WITH CHECK_POLICY = OFF;
ALTER LOGIN [Mary5] WITH CHECK_POLICY = ON;
GO

G. Het wachtwoord van een aanmelding wijzigen met HASHED

In het volgende voorbeeld wordt het wachtwoord van de TestUser aanmelding gewijzigd in een al gehashte waarde.

ALTER LOGIN TestUser WITH PASSWORD = 0x01000CF35567C60BFB41EBDE4CF700A985A13D773D6B45B90900 HASHED;
GO

* SQL Database *

 

SQL Database

Syntaxis voor Azure SQL Database

ALTER LOGIN login_name
  {
      <status_option>
    | WITH <set_option> [ , .. .n ]
  }
[;]

<status_option> ::=
    ENABLE | DISABLE

<set_option> ::=
    PASSWORD = 'password'
    [
      OLD_PASSWORD = 'oldpassword'
    ]
    | NAME = login_name

Argumenten

login_name

Hiermee geeft u de naam op van de SQL Server-aanmelding die wordt gewijzigd. Domeinaanmelding moet tussen vierkante haken staan in de indeling [domein\gebruiker].

INSCHAKELEN | UITSCHAKELEN

Hiermee schakelt u deze aanmelding in of uit. Het uitschakelen van een aanmelding heeft geen invloed op het gedrag van aanmeldingen die al zijn verbonden. (Gebruik de instructie KILL om een bestaande verbinding te beëindigen.) Uitgeschakelde aanmeldingen behouden hun machtigingen en kunnen nog steeds worden geïmiteerd.

PASSWORD = 'wachtwoord'

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u het wachtwoord op voor de aanmelding die wordt gewijzigd. Wachtwoorden zijn hoofdlettergevoelig.

Continu actieve verbindingen met SQL Database vereisen minstens om de 10 uur opnieuw verificatie (uitgevoerd door de database-engine). De database-engine probeert opnieuw te controleren met behulp van het oorspronkelijk ingediende wachtwoord en er is geen gebruikersinvoer vereist. Als een wachtwoord opnieuw wordt ingesteld in SQL Database, wordt de verbinding om prestatieredenen niet opnieuw geverifieerd, zelfs niet als de verbinding opnieuw wordt ingesteld vanwege groepsgewijze verbindingen. Dit verschilt van het gedrag van on-premises SQL Server. Als het wachtwoord is gewijzigd sinds de verbinding in eerste instantie is geautoriseerd, moet de verbinding worden beëindigd en moet er een nieuwe verbinding worden gemaakt met het nieuwe wachtwoord. Een gebruiker met de machtiging KILL DATABASE CONNECTION kan expliciet een verbinding met SQL Database beëindigen met behulp van de KILL-opdracht. Zie KILLvoor meer informatie.

Belangrijk

Wanneer een aanmelding (of een ingesloten databasegebruiker) verbinding maakt en wordt geverifieerd, slaat de verbinding identiteitsgegevens over de aanmelding in de cache op. Voor aanmelding bij Windows-verificatie bevat dit informatie over lidmaatschap van Windows-groepen. De identiteit van de aanmelding blijft geverifieerd zolang de verbinding behouden blijft. Als u wijzigingen in de identiteit wilt afdwingen, zoals het opnieuw instellen van een wachtwoord of wijziging in het windows-groepslidmaatschap, moet de aanmelding zich afmelden bij de verificatie-instantie (Windows of SQL Server) en u opnieuw aanmelden. Een lid van de sysadmin vaste serverfunctie of aanmelding met de ALTER ANY CONNECTION machtiging kan de opdracht KILL gebruiken om een verbinding te beëindigen en een aanmelding af te dwingen om opnieuw verbinding te maken. SQL Server Management Studio kan verbindingsgegevens hergebruiken bij het openen van meerdere verbindingen met Objectverkenner en Query-editorvensters. Sluit alle verbindingen om opnieuw verbinding te maken.

OLD_PASSWORD = 'old_password'

Is alleen van toepassing op SQL Server-aanmeldingen. Het huidige wachtwoord van de aanmelding waaraan een nieuw wachtwoord wordt toegewezen. Wachtwoorden zijn hoofdlettergevoelig.

NAME = login_name

De nieuwe naam van de aanmelding waarvan de naam wordt gewijzigd. Als dit een Windows-aanmelding is, moet de SID van de Windows-principal die overeenkomt met de nieuwe naam overeenkomen met de SID die is gekoppeld aan de aanmelding in SQL Server. De nieuwe naam van een SQL Server-aanmelding mag geen backslashteken (\) bevatten.

Opmerkingen

In SQL Database worden aanmeldingsgegevens die vereist zijn voor het verifiëren van een verbinding en firewallregels op serverniveau tijdelijk in de cache opgeslagen in elke database. Deze cache wordt periodiek vernieuwd. Als u een vernieuwing van de verificatiecache wilt afdwingen en ervoor wilt zorgen dat een database de nieuwste versie van de aanmeldingstabel heeft, voert u DBCC FLUSHAUTHCACHE-uit.

Machtigingen

Hiervoor is ALTER ANY LOGIN-machtiging vereist.

Als de aanmelding die wordt gewijzigd lid is van de sysadmin vaste serverfunctie of een grantee van CONTROL SERVER-machtiging, is ook CONTROL SERVER-machtiging vereist bij het aanbrengen van de volgende wijzigingen:

  • Het wachtwoord opnieuw instellen zonder het oude wachtwoord op te leveren.
  • Wijzig de aanmeldingsnaam.
  • De aanmelding in- of uitschakelen.
  • De aanmelding toewijzen aan een andere referentie.

Een principal kan het wachtwoord voor een eigen aanmelding wijzigen.

Voorbeelden

Deze voorbeelden bevatten ook voorbeelden voor het gebruik van andere SQL-producten. Bekijk welke eerdere argumenten worden ondersteund.

Een. Een uitgeschakelde aanmelding inschakelen

In het volgende voorbeeld wordt de aanmeldings-Mary5ingeschakeld.

ALTER LOGIN Mary5 ENABLE;

B. Het wachtwoord van een aanmelding wijzigen

In het volgende voorbeeld wordt het wachtwoord van aanmelding Mary5 gewijzigd in een sterk wachtwoord.

ALTER LOGIN Mary5 WITH PASSWORD = '<enterStrongPasswordHere>';

C. De naam van een aanmelding wijzigen

In het volgende voorbeeld wordt de naam van de aanmeldings-Mary5 gewijzigd in John2.

ALTER LOGIN Mary5 WITH NAME = John2;

D. Een aanmelding toewijzen aan een referentie

In het volgende voorbeeld wordt de aanmeldings-John2 toegewezen aan de referentie Custodian04.

ALTER LOGIN John2 WITH CREDENTIAL = Custodian04;

E. Een aanmelding toewijzen aan een uitbreidbare sleutelbeheerreferentie

In het volgende voorbeeld wordt de aanmeldings-Mary5 toegewezen aan de EKM-referentie EKMProvider1.

van toepassing op: SQL Server 2008 (10.0.x) en hoger.

ALTER LOGIN Mary5 ADD CREDENTIAL EKMProvider1;
GO

F. Het wachtwoord van een aanmelding wijzigen met HASHED

In het volgende voorbeeld wordt het wachtwoord van de TestUser aanmelding gewijzigd in een al gehashte waarde.

van toepassing op: SQL Server 2008 (10.0.x) en hoger.

ALTER LOGIN TestUser WITH PASSWORD = 0x01000CF35567C60BFB41EBDE4CF700A985A13D773D6B45B90900 HASHED;
GO

* SQL Managed Instance *

 

Azure SQL Managed Instance

Syntaxis voor SQL Server en Azure SQL Managed Instance

ALTER LOGIN login_name
    {
    <status_option>
    | WITH <set_option> [ , ... ]
    | <cryptographic_credential_option>
    }
[;]

<status_option> ::=
        ENABLE | DISABLE

<set_option> ::=
    PASSWORD = 'password' | hashed_password HASHED
    [
      OLD_PASSWORD = 'oldpassword'
      | <password_option> [ <password_option> ]
    ]
    | DEFAULT_DATABASE = database
    | DEFAULT_LANGUAGE = language
    | NAME = login_name
    | CHECK_POLICY = { ON | OFF }
    | CHECK_EXPIRATION = { ON | OFF }
    | CREDENTIAL = credential_name
    | NO CREDENTIAL

<password_option> ::=
    MUST_CHANGE | UNLOCK

<cryptographic_credentials_option> ::=
    ADD CREDENTIAL credential_name
  | DROP CREDENTIAL credential_name
-- Syntax for Azure SQL Managed Instance using Microsoft Entra logins

ALTER LOGIN login_name
  {
      <status_option>
    | WITH <set_option> [ , .. .n ]
  }
[;]

<status_option> ::=
    ENABLE | DISABLE

<set_option> ::=
     DEFAULT_DATABASE = database
   | DEFAULT_LANGUAGE = language

Argumenten

Argumenten die van toepassing zijn op SQL- en Microsoft Entra-aanmeldingen

login_name

Hiermee geeft u de naam op van de SQL Server-aanmelding die wordt gewijzigd. Microsoft Entra-aanmeldingen moeten worden opgegeven als user@domain. Bijvoorbeeld john.smith@contoso.comof als de Microsoft Entra-groep of toepassingsnaam. Voor Microsoft Entra-aanmeldingen moet de login_name overeenkomen met een bestaande Microsoft Entra-aanmelding die is gemaakt in de master-database.

INSCHAKELEN | UITSCHAKELEN

Hiermee schakelt u deze aanmelding in of uit. Het uitschakelen van een aanmelding heeft geen invloed op het gedrag van aanmeldingen die al zijn verbonden. (Gebruik de instructie KILL om een bestaande verbinding te beëindigen.) Uitgeschakelde aanmeldingen behouden hun machtigingen en kunnen nog steeds worden geïmiteerd.

DEFAULT_DATABASE = database-

Hiermee geeft u een standaarddatabase moet worden toegewezen aan de aanmelding.

DEFAULT_LANGUAGE = taal

Hiermee geeft u een standaardtaal die moet worden toegewezen aan de aanmelding. De standaardtaal voor alle SQL Database-aanmeldingen is Engels en kan niet worden gewijzigd. De standaardtaal van de sa aanmelding bij SQL Server op Linux is Engels, maar kan worden gewijzigd.

Argumenten die alleen van toepassing zijn op SQL-aanmeldingen

PASSWORD = 'wachtwoord'

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u het wachtwoord op voor de aanmelding die wordt gewijzigd. Wachtwoorden zijn hoofdlettergevoelig. Wachtwoorden zijn ook niet van toepassing wanneer ze worden gebruikt met externe aanmeldingen, zoals Microsoft Entra-aanmeldingen.

Continu actieve verbindingen met SQL Database vereisen minstens om de 10 uur opnieuw verificatie (uitgevoerd door de database-engine). De database-engine probeert opnieuw te controleren met behulp van het oorspronkelijk ingediende wachtwoord en er is geen gebruikersinvoer vereist. Als een wachtwoord opnieuw wordt ingesteld in SQL Database, wordt de verbinding om prestatieredenen niet opnieuw geverifieerd, zelfs niet als de verbinding opnieuw wordt ingesteld vanwege groepsgewijze verbindingen. Dit verschilt van het gedrag van on-premises SQL Server. Als het wachtwoord is gewijzigd sinds de verbinding in eerste instantie is geautoriseerd, moet de verbinding worden beëindigd en moet er een nieuwe verbinding worden gemaakt met het nieuwe wachtwoord. Een gebruiker met de machtiging KILL DATABASE CONNECTION kan expliciet een verbinding met SQL Database beëindigen met behulp van de KILL-opdracht. Zie KILLvoor meer informatie.

PASSWORD = hashed_password

Alleen van toepassing op het trefwoord HASHED. Hiermee geeft u de gehashte waarde van het wachtwoord voor de aanmelding die wordt gemaakt.

HASHED

Alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u op dat het wachtwoord dat is ingevoerd nadat het argument PASSWORD al is gehasht. Als deze optie niet is geselecteerd, wordt het wachtwoord gehasht voordat het in de database wordt opgeslagen. Deze optie mag alleen worden gebruikt voor aanmeldingssynchronisatie tussen twee servers. Gebruik de optie HASHED niet om wachtwoorden regelmatig te wijzigen.

OLD_PASSWORD = 'old_password'

Is alleen van toepassing op SQL Server-aanmeldingen. Het huidige wachtwoord van de aanmelding waaraan een nieuw wachtwoord wordt toegewezen. Wachtwoorden zijn hoofdlettergevoelig.

MUST_CHANGE

Is alleen van toepassing op SQL Server-aanmeldingen. Als deze optie is opgenomen, vraagt SQL Server om een bijgewerkt wachtwoord wanneer de aanmelding voor het eerst wordt gebruikt.

NAME = login_name

De nieuwe naam van de aanmelding waarvan de naam wordt gewijzigd. Als de aanmelding een Windows-aanmelding is, moet de SID van de Windows-principal die overeenkomt met de nieuwe naam overeenkomen met de SID die is gekoppeld aan de aanmelding in SQL Server. De nieuwe naam van een SQL Server-aanmelding mag geen backslashteken (\) bevatten.

CHECK_EXPIRATION = { AAN | UIT }

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u op of het wachtwoordverloopbeleid moet worden afgedwongen bij deze aanmelding. De standaardwaarde is UIT.

CHECK_POLICY = { ON | UIT }

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u op dat het Windows-wachtwoordbeleid van de computer waarop SQL Server wordt uitgevoerd, moet worden afgedwongen bij deze aanmelding. De standaardwaarde is AAN.

CREDENTIAL = credential_name

De naam van een referentie die moet worden toegewezen aan een SQL Server-aanmelding. De referentie moet al aanwezig zijn op de server. Zie Referentiesvoor meer informatie. Een referentie kan niet worden toegewezen aan de sa-aanmelding.

GEEN REFERENTIE

Hiermee verwijdert u alle bestaande toewijzingen van de aanmelding aan een serverreferentie. Zie Referentiesvoor meer informatie.

ONTSLUITEN

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u op dat een aanmelding die is vergrendeld, moet worden ontgrendeld.

REFERENTIE TOEVOEGEN

Hiermee voegt u een EKM-providerreferentie (Extensible Key Management) toe aan de aanmelding. Zie EKM (Extensible Key Management)voor meer informatie.

DROP CREDENTIAL

Hiermee verwijdert u een EKM-providerreferentie (Extensible Key Management) uit de aanmelding. Zie EKM (Extensible Key Management)voor meer informatie.

Opmerkingen

Wanneer CHECK_POLICY is ingesteld op AAN, kan het argument HASHED niet worden gebruikt.

Wanneer CHECK_POLICY wordt gewijzigd in AAN, treedt het volgende gedrag op:

  • De wachtwoordgeschiedenis wordt geïnitialiseerd met de waarde van de huidige wachtwoord-hash.

Wanneer CHECK_POLICY wordt gewijzigd in UIT, treedt het volgende gedrag op:

  • CHECK_EXPIRATION is ook ingesteld op UIT.
  • De wachtwoordgeschiedenis is gewist.
  • De waarde van lockout_time wordt opnieuw ingesteld.

Als MUST_CHANGE is opgegeven, moeten CHECK_EXPIRATION en CHECK_POLICY worden ingesteld op AAN. Anders mislukt de instructie.

Als CHECK_POLICY is ingesteld op UIT, kan CHECK_EXPIRATION niet worden ingesteld op AAN. Een ALTER LOGIN-instructie met deze combinatie van opties mislukt.

U kunt ALTER_LOGIN niet gebruiken met het argument UITSCHAKELEN om de toegang tot een Windows-groep te weigeren. Dit is standaard. Bijvoorbeeld: ALTER_LOGIN [domein\groep] DISABLE retourneert het volgende foutbericht:

"Msg 15151, Level 16, State 1, Line 1 "Cannot alter the login '*Domain\Group*', because it doesn't exist or you don't have permission."

In SQL Database worden aanmeldingsgegevens die vereist zijn voor het verifiëren van een verbinding en firewallregels op serverniveau tijdelijk in de cache opgeslagen in elke database. Deze cache wordt periodiek vernieuwd. Als u een vernieuwing van de verificatiecache wilt afdwingen en ervoor wilt zorgen dat een database de nieuwste versie van de aanmeldingstabel heeft, voert u DBCC FLUSHAUTHCACHE-uit.

Machtigingen

Hiervoor is ALTER ANY LOGIN-machtiging vereist.

Als de optie CREDENTIAL wordt gebruikt, is ook ALTER ANY CREDENTIAL-machtiging vereist.

Als de aanmelding die wordt gewijzigd lid is van de sysadmin vaste serverfunctie of een grantee van CONTROL SERVER-machtiging, is ook CONTROL SERVER-machtiging vereist bij het aanbrengen van de volgende wijzigingen:

  • Het wachtwoord opnieuw instellen zonder het oude wachtwoord op te leveren.
  • MUST_CHANGE, CHECK_POLICY of CHECK_EXPIRATION inschakelen.
  • Wijzig de aanmeldingsnaam.
  • De aanmelding in- of uitschakelen.
  • De aanmelding toewijzen aan een andere referentie.

Een principal kan het wachtwoord, de standaardtaal en de standaarddatabase wijzigen voor een eigen aanmelding.

Alleen een SQL-principal met sysadmin bevoegdheden kan een ALTER LOGIN-opdracht uitvoeren voor een Microsoft Entra-aanmelding.

Voorbeelden

Deze voorbeelden bevatten ook voorbeelden voor het gebruik van andere SQL-producten. Bekijk welke eerdere argumenten worden ondersteund.

Een. Een uitgeschakelde aanmelding inschakelen

In het volgende voorbeeld wordt de aanmeldings-Mary5ingeschakeld.

ALTER LOGIN Mary5 ENABLE;

B. Het wachtwoord van een aanmelding wijzigen

In het volgende voorbeeld wordt het wachtwoord van aanmelding Mary5 gewijzigd in een sterk wachtwoord.

ALTER LOGIN Mary5 WITH PASSWORD = '<enterStrongPasswordHere>';

C. De naam van een aanmelding wijzigen

In het volgende voorbeeld wordt de naam van de aanmeldings-Mary5 gewijzigd in John2.

ALTER LOGIN Mary5 WITH NAME = John2;

D. Een aanmelding toewijzen aan een referentie

In het volgende voorbeeld wordt de aanmeldings-John2 toegewezen aan de referentie Custodian04.

ALTER LOGIN John2 WITH CREDENTIAL = Custodian04;

E. Een aanmelding toewijzen aan een uitbreidbare sleutelbeheerreferentie

In het volgende voorbeeld wordt de aanmeldings-Mary5 toegewezen aan de EKM-referentie EKMProvider1.

is van toepassing op: SQL Server 2008 (10.0.x) en hoger en Azure SQL Managed Instance.

ALTER LOGIN Mary5 ADD CREDENTIAL EKMProvider1;
GO

F. Een aanmelding ontgrendelen

Als u een SQL Server-aanmelding wilt ontgrendelen, voert u de volgende instructie uit, waarbij u **** vervangt door het gewenste accountwachtwoord.

ALTER LOGIN [Mary5] WITH PASSWORD = '****' UNLOCK;
GO

Als u een aanmelding wilt ontgrendelen zonder het wachtwoord te wijzigen, schakelt u het controlebeleid uit en schakelt u het opnieuw in.

ALTER LOGIN [Mary5] WITH CHECK_POLICY = OFF;

ALTER LOGIN [Mary5] WITH CHECK_POLICY = ON;
GO

G. Het wachtwoord van een aanmelding wijzigen met HASHED

In het volgende voorbeeld wordt het wachtwoord van de TestUser aanmelding gewijzigd in een al gehashte waarde.

is van toepassing op: SQL Server 2008 (10.0.x) en hoger en Azure SQL Managed Instance.

ALTER LOGIN TestUser WITH PASSWORD = 0x01000CF35567C60BFB41EBDE4CF700A985A13D773D6B45B90900 HASHED;
GO

H. De aanmelding van een Microsoft Entra-gebruiker uitschakelen

In het volgende voorbeeld wordt de aanmelding van een Microsoft Entra-gebruiker joe@contoso.comuitgeschakeld.

ALTER LOGIN [joe@contoso.com] DISABLE;

* Azure Synapse
Analyse *

 

Azure Synapse Analytics

Syntaxis voor Azure Synapse

ALTER LOGIN login_name
  {
      <status_option>
    | WITH <set_option> [ , .. .n ]
  }
[;]

<status_option> ::=
    ENABLE | DISABLE

<set_option> ::=
    PASSWORD = 'password'
    [
      OLD_PASSWORD = 'oldpassword'
    ]
    | NAME = login_name

Argumenten

login_name

Hiermee geeft u de naam op van de SQL Server-aanmelding die wordt gewijzigd. Domeinaanmelding moet tussen vierkante haken staan in de indeling [domein\gebruiker].

INSCHAKELEN | UITSCHAKELEN

Hiermee schakelt u deze aanmelding in of uit. Het uitschakelen van een aanmelding heeft geen invloed op het gedrag van aanmeldingen die al zijn verbonden. (Gebruik de instructie KILL om een bestaande verbinding te beëindigen.) Uitgeschakelde aanmeldingen behouden hun machtigingen en kunnen nog steeds worden geïmiteerd.

PASSWORD = 'wachtwoord'

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u het wachtwoord op voor de aanmelding die wordt gewijzigd. Wachtwoorden zijn hoofdlettergevoelig.

Continu actieve verbindingen met SQL Database vereisen minstens om de 10 uur opnieuw verificatie (uitgevoerd door de database-engine). De database-engine probeert opnieuw te controleren met behulp van het oorspronkelijk ingediende wachtwoord en er is geen gebruikersinvoer vereist. Als een wachtwoord opnieuw wordt ingesteld in SQL Database, wordt de verbinding om prestatieredenen niet opnieuw geverifieerd, zelfs niet als de verbinding opnieuw wordt ingesteld vanwege groepsgewijze verbindingen. Dit verschilt van het gedrag van on-premises SQL Server. Als het wachtwoord is gewijzigd sinds de verbinding in eerste instantie is geautoriseerd, moet de verbinding worden beëindigd en moet er een nieuwe verbinding worden gemaakt met het nieuwe wachtwoord. Een gebruiker met de machtiging KILL DATABASE CONNECTION kan expliciet een verbinding met SQL Database beëindigen met behulp van de KILL-opdracht. Zie KILLvoor meer informatie.

Belangrijk

Wanneer een aanmelding (of een ingesloten databasegebruiker) verbinding maakt en wordt geverifieerd, slaat de verbinding identiteitsgegevens over de aanmelding in de cache op. Voor aanmelding bij Windows-verificatie bevat dit informatie over lidmaatschap van Windows-groepen. De identiteit van de aanmelding blijft geverifieerd zolang de verbinding behouden blijft. Als u wijzigingen in de identiteit wilt afdwingen, zoals het opnieuw instellen van een wachtwoord of wijziging in het windows-groepslidmaatschap, moet de aanmelding zich afmelden bij de verificatie-instantie (Windows of SQL Server) en u opnieuw aanmelden. Een lid van de sysadmin vaste serverfunctie of aanmelding met de ALTER ANY CONNECTION machtiging kan de opdracht KILL gebruiken om een verbinding te beëindigen en een aanmelding af te dwingen om opnieuw verbinding te maken. SQL Server Management Studio kan verbindingsgegevens hergebruiken bij het openen van meerdere verbindingen met Objectverkenner en Query-editorvensters. Sluit alle verbindingen om opnieuw verbinding te maken.

OLD_PASSWORD = 'old_password'

Is alleen van toepassing op SQL Server-aanmeldingen. Het huidige wachtwoord van de aanmelding waaraan een nieuw wachtwoord wordt toegewezen. Wachtwoorden zijn hoofdlettergevoelig.

NAME = login_name

De nieuwe naam van de aanmelding waarvan de naam wordt gewijzigd. Als dit een Windows-aanmelding is, moet de SID van de Windows-principal die overeenkomt met de nieuwe naam overeenkomen met de SID die is gekoppeld aan de aanmelding in SQL Server. De nieuwe naam van een SQL Server-aanmelding mag geen backslashteken (\) bevatten.

Opmerkingen

In SQL Database worden aanmeldingsgegevens die vereist zijn voor het verifiëren van een verbinding en firewallregels op serverniveau tijdelijk in de cache opgeslagen in elke database. Deze cache wordt periodiek vernieuwd. Als u een vernieuwing van de verificatiecache wilt afdwingen en ervoor wilt zorgen dat een database de nieuwste versie van de aanmeldingstabel heeft, voert u DBCC FLUSHAUTHCACHE-uit.

Machtigingen

Hiervoor is ALTER ANY LOGIN-machtiging vereist.

Als de aanmelding die wordt gewijzigd lid is van de sysadmin vaste serverfunctie of een grantee van CONTROL SERVER-machtiging, is ook CONTROL SERVER-machtiging vereist bij het aanbrengen van de volgende wijzigingen:

  • Het wachtwoord opnieuw instellen zonder het oude wachtwoord op te leveren.
  • Wijzig de aanmeldingsnaam.
  • De aanmelding in- of uitschakelen.
  • De aanmelding toewijzen aan een andere referentie.

Een principal kan het wachtwoord voor een eigen aanmelding wijzigen.

Voorbeelden

Deze voorbeelden bevatten ook voorbeelden voor het gebruik van andere SQL-producten. Bekijk welke eerdere argumenten worden ondersteund.

Een. Een uitgeschakelde aanmelding inschakelen

In het volgende voorbeeld wordt de aanmeldings-Mary5ingeschakeld.

ALTER LOGIN Mary5 ENABLE;

B. Het wachtwoord van een aanmelding wijzigen

In het volgende voorbeeld wordt het wachtwoord van aanmelding Mary5 gewijzigd in een sterk wachtwoord.

ALTER LOGIN Mary5 WITH PASSWORD = '<enterStrongPasswordHere>';

C. De naam van een aanmelding wijzigen

In het volgende voorbeeld wordt de naam van de aanmeldings-Mary5 gewijzigd in John2.

ALTER LOGIN Mary5 WITH NAME = John2;

D. Een aanmelding toewijzen aan een referentie

In het volgende voorbeeld wordt de aanmeldings-John2 toegewezen aan de referentie Custodian04.

ALTER LOGIN John2 WITH CREDENTIAL = Custodian04;

E. Een aanmelding toewijzen aan een uitbreidbare sleutelbeheerreferentie

In het volgende voorbeeld wordt de aanmeldings-Mary5 toegewezen aan de EKM-referentie EKMProvider1.

van toepassing op: SQL Server 2008 (10.0.x) en hoger.

ALTER LOGIN Mary5 ADD CREDENTIAL EKMProvider1;
GO

F. Een aanmelding ontgrendelen

Als u een SQL Server-aanmelding wilt ontgrendelen, voert u de volgende instructie uit, waarbij u **** vervangt door het gewenste accountwachtwoord.

ALTER LOGIN [Mary5] WITH PASSWORD = '****' UNLOCK;
GO

G. Het wachtwoord van een aanmelding wijzigen met HASHED

In het volgende voorbeeld wordt het wachtwoord van de TestUser aanmelding gewijzigd in een al gehashte waarde.

van toepassing op: SQL Server 2008 (10.0.x) en hoger.

ALTER LOGIN TestUser WITH PASSWORD = 0x01000CF35567C60BFB41EBDE4CF700A985A13D773D6B45B90900 HASHED;
GO

* Analyse
Platform System (PDW) *

 

Analyseplatformsysteem

Syntaxis voor Analytics Platform System

ALTER LOGIN login_name
    {
    <status_option>
    | WITH <set_option> [ , ... ]
    }

<status_option> ::= ENABLE | DISABLE

<set_option> ::=
    PASSWORD = 'password'
    [
      OLD_PASSWORD = 'oldpassword'
      | <password_option> [ <password_option> ]
    ]
    | NAME = login_name
    | CHECK_POLICY = { ON | OFF }
    | CHECK_EXPIRATION = { ON | OFF }

<password_option> ::=
    MUST_CHANGE | UNLOCK

Argumenten

login_name

Hiermee geeft u de naam op van de SQL Server-aanmelding die wordt gewijzigd. Domeinaanmelding moet tussen vierkante haken staan in de indeling [domein\gebruiker].

INSCHAKELEN | UITSCHAKELEN

Hiermee schakelt u deze aanmelding in of uit. Het uitschakelen van een aanmelding heeft geen invloed op het gedrag van aanmeldingen die al zijn verbonden. (Gebruik de instructie KILL om een bestaande verbinding te beëindigen.) Uitgeschakelde aanmeldingen behouden hun machtigingen en kunnen nog steeds worden geïmiteerd.

PASSWORD = 'wachtwoord'

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u het wachtwoord op voor de aanmelding die wordt gewijzigd. Wachtwoorden zijn hoofdlettergevoelig.

Belangrijk

Wanneer een aanmelding (of een ingesloten databasegebruiker) verbinding maakt en wordt geverifieerd, slaat de verbinding identiteitsgegevens over de aanmelding in de cache op. Voor aanmelding bij Windows-verificatie bevat dit informatie over lidmaatschap van Windows-groepen. De identiteit van de aanmelding blijft geverifieerd zolang de verbinding behouden blijft. Als u wijzigingen in de identiteit wilt afdwingen, zoals het opnieuw instellen van een wachtwoord of wijziging in het windows-groepslidmaatschap, moet de aanmelding zich afmelden bij de verificatie-instantie (Windows of SQL Server) en u opnieuw aanmelden. Een lid van de sysadmin vaste serverfunctie of aanmelding met de ALTER ANY CONNECTION machtiging kan de opdracht KILL gebruiken om een verbinding te beëindigen en een aanmelding af te dwingen om opnieuw verbinding te maken. SQL Server Management Studio kan verbindingsgegevens hergebruiken bij het openen van meerdere verbindingen met Objectverkenner en Query-editorvensters. Sluit alle verbindingen om opnieuw verbinding te maken.

OLD_PASSWORD = 'old_password'

Is alleen van toepassing op SQL Server-aanmeldingen. Het huidige wachtwoord van de aanmelding waaraan een nieuw wachtwoord wordt toegewezen. Wachtwoorden zijn hoofdlettergevoelig.

MUST_CHANGE

Is alleen van toepassing op SQL Server-aanmeldingen. Als deze optie is opgenomen, vraagt SQL Server om een bijgewerkt wachtwoord wanneer de aanmelding voor het eerst wordt gebruikt.

NAME = login_name

De nieuwe naam van de aanmelding waarvan de naam wordt gewijzigd. Als de aanmelding een Windows-aanmelding is, moet de SID van de Windows-principal die overeenkomt met de nieuwe naam overeenkomen met de SID die is gekoppeld aan de aanmelding in SQL Server. De nieuwe naam van een SQL Server-aanmelding mag geen backslashteken (\) bevatten.

CHECK_EXPIRATION = { AAN | UIT }

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u op of het wachtwoordverloopbeleid moet worden afgedwongen bij deze aanmelding. De standaardwaarde is UIT.

CHECK_POLICY = { ON | UIT }

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u op dat het Windows-wachtwoordbeleid van de computer waarop SQL Server wordt uitgevoerd, moet worden afgedwongen bij deze aanmelding. De standaardwaarde is AAN.

ONTSLUITEN

Is alleen van toepassing op SQL Server-aanmeldingen. Hiermee geeft u op dat een aanmelding die is vergrendeld, moet worden ontgrendeld.

Opmerkingen

Wanneer CHECK_POLICY is ingesteld op AAN, kan het argument HASHED niet worden gebruikt.

Wanneer CHECK_POLICY wordt gewijzigd in AAN, treedt het volgende gedrag op:

  • De wachtwoordgeschiedenis wordt geïnitialiseerd met de waarde van de huidige wachtwoord-hash.

Wanneer CHECK_POLICY wordt gewijzigd in UIT, treedt het volgende gedrag op:

  • CHECK_EXPIRATION is ook ingesteld op UIT.
  • De wachtwoordgeschiedenis is gewist.
  • De waarde van lockout_time wordt opnieuw ingesteld.

Als MUST_CHANGE is opgegeven, moeten CHECK_EXPIRATION en CHECK_POLICY worden ingesteld op AAN. Anders mislukt de instructie.

Als CHECK_POLICY is ingesteld op UIT, kan CHECK_EXPIRATION niet worden ingesteld op AAN. Een ALTER LOGIN-instructie met deze combinatie van opties mislukt.

U kunt ALTER_LOGIN niet gebruiken met het argument UITSCHAKELEN om de toegang tot een Windows-groep te weigeren. Dit is standaard. Bijvoorbeeld: ALTER_LOGIN [domein\groep] DISABLE retourneert het volgende foutbericht:

"Msg 15151, Level 16, State 1, Line 1 "Cannot alter the login '*Domain\Group*', because it doesn't exist or you don't have permission."

In SQL Database worden aanmeldingsgegevens die vereist zijn voor het verifiëren van een verbinding en firewallregels op serverniveau tijdelijk in de cache opgeslagen in elke database. Deze cache wordt periodiek vernieuwd. Als u een vernieuwing van de verificatiecache wilt afdwingen en ervoor wilt zorgen dat een database de nieuwste versie van de aanmeldingstabel heeft, voert u DBCC FLUSHAUTHCACHE-uit.

Machtigingen

Hiervoor is ALTER ANY LOGIN-machtiging vereist.

Als de optie CREDENTIAL wordt gebruikt, is ook ALTER ANY CREDENTIAL-machtiging vereist.

Als de aanmelding die wordt gewijzigd lid is van de sysadmin vaste serverfunctie of een grantee van CONTROL SERVER-machtiging, is ook CONTROL SERVER-machtiging vereist bij het aanbrengen van de volgende wijzigingen:

  • Het wachtwoord opnieuw instellen zonder het oude wachtwoord op te leveren.
  • MUST_CHANGE, CHECK_POLICY of CHECK_EXPIRATION inschakelen.
  • Wijzig de aanmeldingsnaam.
  • De aanmelding in- of uitschakelen.
  • De aanmelding toewijzen aan een andere referentie.

Een principal kan het wachtwoord, de standaardtaal en de standaarddatabase wijzigen voor een eigen aanmelding.

Voorbeelden

Deze voorbeelden bevatten ook voorbeelden voor het gebruik van andere SQL-producten. Bekijk welke eerdere argumenten worden ondersteund.

Een. Een uitgeschakelde aanmelding inschakelen

In het volgende voorbeeld wordt de aanmeldings-Mary5ingeschakeld.

ALTER LOGIN Mary5 ENABLE;

B. Het wachtwoord van een aanmelding wijzigen

In het volgende voorbeeld wordt het wachtwoord van aanmelding Mary5 gewijzigd in een sterk wachtwoord.

ALTER LOGIN Mary5 WITH PASSWORD = '<enterStrongPasswordHere>';

C. De naam van een aanmelding wijzigen

In het volgende voorbeeld wordt de naam van de aanmeldings-Mary5 gewijzigd in John2.

ALTER LOGIN Mary5 WITH NAME = John2;

D. Een aanmelding toewijzen aan een referentie

In het volgende voorbeeld wordt de aanmeldings-John2 toegewezen aan de referentie Custodian04.

ALTER LOGIN John2 WITH CREDENTIAL = Custodian04;

E. Een aanmelding toewijzen aan een uitbreidbare sleutelbeheerreferentie

In het volgende voorbeeld wordt de aanmeldings-Mary5 toegewezen aan de EKM-referentie EKMProvider1.

van toepassing op: SQL Server 2008 (10.0.x) en hoger.

ALTER LOGIN Mary5 ADD CREDENTIAL EKMProvider1;
GO

F. Een aanmelding ontgrendelen

Als u een SQL Server-aanmelding wilt ontgrendelen, voert u de volgende instructie uit, waarbij u **** vervangt door het gewenste accountwachtwoord.

ALTER LOGIN [Mary5] WITH PASSWORD = '****' UNLOCK;
GO

Als u een aanmelding wilt ontgrendelen zonder het wachtwoord te wijzigen, schakelt u het controlebeleid uit en schakelt u het opnieuw in.

ALTER LOGIN [Mary5] WITH CHECK_POLICY = OFF;

ALTER LOGIN [Mary5] WITH CHECK_POLICY = ON;
GO

G. Het wachtwoord van een aanmelding wijzigen met HASHED

In het volgende voorbeeld wordt het wachtwoord van de TestUser aanmelding gewijzigd in een al gehashte waarde.

van toepassing op: SQL Server 2008 (10.0.x) en hoger.

ALTER LOGIN TestUser WITH PASSWORD = 0x01000CF35567C60BFB41EBDE4CF700A985A13D773D6B45B90900 HASHED;
GO