SqlConnection.ChangePassword 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
SQL Server 암호를 변경합니다.
오버로드
| Name | Description |
|---|---|
| ChangePassword(String, SqlCredential, SecureString) |
SqlCredential 개체에 표시된 사용자의 SQL Server 암호를 변경합니다. |
| ChangePassword(String, String) |
연결 문자열에 표시된 사용자의 SQL Server 암호를 지정된 새 암호로 변경합니다. |
ChangePassword(String, SqlCredential, SecureString)
SqlCredential 개체에 표시된 사용자의 SQL Server 암호를 변경합니다.
public:
static void ChangePassword(System::String ^ connectionString, System::Data::SqlClient::SqlCredential ^ credential, System::Security::SecureString ^ newSecurePassword);public static void ChangePassword(string connectionString, System.Data.SqlClient.SqlCredential credential, System.Security.SecureString newSecurePassword);static member ChangePassword : string * System.Data.SqlClient.SqlCredential * System.Security.SecureString -> unitPublic Shared Sub ChangePassword (connectionString As String, credential As SqlCredential, newSecurePassword As SecureString)매개 변수
- connectionString
- String
서버에 연결할 수 있는 충분한 정보가 포함된 연결 문자열입니다. 연결 문자열은 Integrated Security = true, UserId또는 Password; 연결 문자열 키워드를 사용하지 않아야 합니다. 또는 ContextConnection = true.
- credential
- SqlCredential
SqlCredential 개체입니다.
- newPasswordnewSecurePassword
- SecureString
새 암호입니다.
newPassword 읽기 전용이어야 합니다. 또한 암호는 서버에 설정된 암호 보안 정책(예: 특정 문자에 대한 최소 길이 및 요구 사항)을 준수해야 합니다.
예외
연결 문자열에는 UserId, Password또는 Integrated Security=true조합이 포함되어 있습니다.
-또는-
연결 문자열에 Context Connection=true포함됩니다.
-또는-
newSecurePassword(또는 newPassword)가 128자보다 큽니다.
-또는-
newSecurePassword(또는 newPassword)은 읽기 전용이 아닙니다.
-또는-
newSecurePassword(또는 newPassword)은 빈 문자열입니다.
매개 변수(connectionString, credential또는 newSecurePassword) 중 하나가 null입니다.
추가 정보
적용 대상
ChangePassword(String, String)
연결 문자열에 표시된 사용자의 SQL Server 암호를 지정된 새 암호로 변경합니다.
public:
static void ChangePassword(System::String ^ connectionString, System::String ^ newPassword);public static void ChangePassword(string connectionString, string newPassword);static member ChangePassword : string * string -> unitPublic Shared Sub ChangePassword (connectionString As String, newPassword As String)매개 변수
- connectionString
- String
원하는 서버에 연결할 수 있는 충분한 정보가 포함된 연결 문자열입니다. 연결 문자열에는 사용자 ID와 현재 암호가 포함되어야 합니다.
- newPassword
- String
설정할 새 암호입니다. 이 암호는 최소 길이, 특정 문자에 대한 요구 사항 등을 포함하여 서버에 설정된 암호 보안 정책을 준수해야 합니다.
예외
connectionString 또는 newPassword 매개 변수가 null입니다.
설명
Windows Server에서 SQL Server를 사용하는 경우 클라이언트 애플리케이션이 기존 암호를 변경하기 위해 현재 암호와 새 암호를 모두 제공할 수 있는 기능을 활용할 수 있습니다. 애플리케이션은 이전 암호가 만료된 경우 초기 로그인 중에 사용자에게 새 암호를 요청하는 등의 기능을 구현할 수 있으며 관리자의 개입 없이 이 작업을 완료할 수 있습니다.
경고
안전하지 않은 패턴이므로 사용자 이름과 암호를 직접 제공하지 않는 것이 좋습니다. 가능한 경우Azure 리소스에 대한
ChangePassword 메서드는 제공된 connectionString 매개 변수에 표시된 사용자의 SQL Server 암호를 newPassword 매개 변수에 제공된 값으로 변경합니다. 연결 문자열에 통합 보안(즉, "통합 보안=True" 또는 이와 동등한) 옵션이 포함되어 있으면 예외가 throw됩니다.
암호가 만료되었는지 확인하려면 Open 메서드를 호출하면 SqlException발생합니다. 연결 문자열 내에 포함된 암호를 다시 설정해야 함을 나타내기 위해 예외의 Number 속성에는 상태 값 18487 또는 18488이 포함됩니다. 첫 번째 값(18487)은 암호가 만료되었음을 나타내고 두 번째 값(18488)은 로그인하기 전에 암호를 재설정해야 임을 나타냅니다.
이 메서드는 서버에 대한 자체 연결을 열고, 암호 변경을 요청하고, 완료되는 즉시 연결을 닫습니다. 이 연결은 SQL Server 연결 풀에서 검색되거나 반환되지 않습니다.
