Add-SqlLogin

구문

ByPath (기본값)

Add-SqlLogin
    [[-Path] <String>]
    -LoginType <LoginType>
    [-LoginName <String>]
    [-DefaultDatabase <String>]
    [-EnforcePasswordPolicy]
    [-EnforcePasswordExpiration]
    [-MustChangePasswordAtNextLogin]
    [-Certificate <String>]
    [-AsymmetricKey <String>]
    [-CredentialName <String>]
    [-LoginPSCredential <PSCredential>]
    [-Enable]
    [-GrantConnectSql]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [<CommonParameters>]

ByObject

Add-SqlLogin
    [[-InputObject] <Server>]
    -LoginType <LoginType>
    [-LoginName <String>]
    [-DefaultDatabase <String>]
    [-EnforcePasswordPolicy]
    [-EnforcePasswordExpiration]
    [-MustChangePasswordAtNextLogin]
    [-Certificate <String>]
    [-AsymmetricKey <String>]
    [-CredentialName <String>]
    [-LoginPSCredential <PSCredential>]
    [-Enable]
    [-GrantConnectSql]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [<CommonParameters>]

ByName

Add-SqlLogin
    [[-ServerInstance] <String[]>]
    -LoginType <LoginType>
    [-LoginName <String>]
    [-DefaultDatabase <String>]
    [-EnforcePasswordPolicy]
    [-EnforcePasswordExpiration]
    [-MustChangePasswordAtNextLogin]
    [-Certificate <String>]
    [-AsymmetricKey <String>]
    [-CredentialName <String>]
    [-LoginPSCredential <PSCredential>]
    [-Enable]
    [-GrantConnectSql]
    [-Credential <PSCredential>]
    [-ConnectionTimeout <Int32>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [<CommonParameters>]

Description

예제

예제 1: SqlLogin 형식 만들기

PS C:\> Add-SqlLogin -ServerInstance "MyServerInstance" -LoginName "MyLogin" -LoginType "SqlLogin" -DefaultDatabase "OtherDatabase"

Name                                          Login Type    Created
----                                          ----------    -------
MyLogin                                       SqlLogin      8/11/2016 3:19 PM

예제 2: 비대칭 키 형식 만들기

PS C:\> Add-SqlLogin -ServerInstance "MyServerInstance" -LoginName "MyLogin" -LoginType "AsymmetricKey" -AsymmetricKey "MyKey" -CredentialName "MyCredential"

Name                                          Login Type    Created
----                                          ----------    -------
MyLogin                                       AsymmetricKey 8/11/2016 4:08 PM

매개 변수

-AccessToken

사용자/암호 또는 Windows 인증 대신 SQL Server에 인증하는 데 사용되는 액세스 토큰입니다.

예를 들어 연결하거나 SQL Azure DB 사용하려면 SQL Azure Managed Instance 이 메서드를 Service PrincipalManaged Identity사용할 수 있습니다.

사용할 매개 변수는 토큰을 나타내는 문자열이거나 PSAccessToken 실행 Get-AzAccessToken -ResourceUrl https://database.windows.net하여 반환된 개체일 수 있습니다.

이 매개 변수는 모듈의 v22에서 새로 생성됩니다.

매개 변수 속성

매개 변수 집합

-AsymmetricKey

로그인 개체의 비대칭 키 이름을 지정합니다. LoginType 매개 변수에 AsymmetricKey 값이 있는 경우 비대칭 키를 지정합니다.

매개 변수 속성

매개 변수 집합

-Certificate

로그인 개체의 인증서 이름을 지정합니다. LoginType에 인증서 값이 있는 경우 인증서를 지정합니다.

매개 변수 속성

매개 변수 집합

-ConnectionTimeout

시간 제한 오류가 발생하기 전에 서버 연결을 대기할 시간(초)을 지정합니다. 제한 시간 값은 0에서 65534 사이의 정수여야 합니다. 0을 지정하면 연결 시도가 시간 초과되지 않습니다.

매개 변수 속성

매개 변수 집합

-Credential

SQL Server 연결에 대한 PSCredential 개체를 지정합니다. 자격 증명 개체를 가져오려면 Get-Credential cmdlet을 사용합니다. 자세한 내용은 get-credential Get-Help 입력합니다.

매개 변수 속성

매개 변수 집합

-CredentialName

로그인 개체의 자격 증명 이름을 지정합니다.

매개 변수 속성

매개 변수 집합

-DefaultDatabase

로그인 개체의 기본 데이터베이스를 지정합니다. 기본값은 master입니다.

매개 변수 속성

매개 변수 집합

-Enable

로그인 개체가 사용하도록 설정되어 있음을 나타냅니다. 기본적으로 로그인 개체는 사용하지 않도록 설정됩니다.

WindowsGroup 형식 개체는 항상 사용하도록 설정됩니다. 이 매개 변수는 영향을 주지 않습니다.

매개 변수 속성

매개 변수 집합

-Encrypt

SQL Server에 연결할 때 사용할 암호화 유형입니다.

이 값은 Encrypt Microsoft.Data.SqlClient 드라이버의 SqlConnection 개체에 있는 속성 SqlConnectionEncryptOption 에 매핑됩니다.

모듈의 v22에서 기본값은 Optional v21과의 호환성을 위한 것입니다. 모듈의 v23+에서 기본값은 기존 스크립트에 대한 호환성이 손상되는 변경을 만들 수 있는 '필수'입니다.

이 매개 변수는 모듈의 v22에서 새로 생성됩니다.

매개 변수 속성

매개 변수 집합

-EnforcePasswordExpiration

로그인 개체에 대해 암호 만료 정책이 적용됨을 나타냅니다. 이 매개 변수는 SqlLogin 형식 개체만 적용합니다. 이 매개 변수는 EnforcePasswordPolicy 매개 변수를 의미합니다. 둘 다 지정할 필요는 없습니다.

매개 변수 속성

매개 변수 집합

-EnforcePasswordPolicy

로그인 개체에 대해 암호 정책이 적용됨을 나타냅니다. 이 매개 변수는 SqlLogin 형식 개체만 적용합니다.

매개 변수 속성

매개 변수 집합

-GrantConnectSql

로그인 개체가 데이터베이스 엔진에 연결할 수 있는 권한이 거부되지 않음을 나타냅니다. 기본적으로 대상 서버가 SQL Azure가 아닌 한 로그인 개체는 데이터베이스 엔진에 연결할 수 있는 권한이 거부됩니다.

매개 변수 속성

매개 변수 집합

-HostNameInCertificate

SQL Server TLS/SSL 인증서의 유효성을 검사할 때 사용할 호스트 이름입니다. SQL Server 인스턴스가 Force Encryption을 사용하도록 설정되어 있고 호스트 이름/짧은 이름을 사용하여 인스턴스에 연결하려는 경우 이 매개 변수를 전달해야 합니다. 이 매개 변수를 생략하면 강제 암호화를 사용하도록 설정된 SQL Server 인스턴스에 연결하려면 FQDN(정규화된 도메인 이름)을 -ServerInstance 전달해야 합니다.

이 매개 변수는 모듈의 v22에서 새로 생성됩니다.

매개 변수 속성

매개 변수 집합

-InputObject

이 cmdlet이 작동하는 SQL Server SMO(SQL Server Management Objects) 개체를 지정합니다.

매개 변수 속성

매개 변수 집합

-LoginName

로그인 개체의 이름을 지정합니다. 대/소문자 구분은 SQL Server 인스턴스와 동일합니다.

매개 변수 속성

매개 변수 집합

-LoginPSCredential

로그인 개체가 프롬프트 없이 이름과 암호를 제공할 수 있도록 하는 PSCredential 개체를 지정합니다.

매개 변수 속성

매개 변수 집합

-LoginType

로그인 개체의 형식을 Microsoft.SqlServer.Management.Smo.LoginType 값으로 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• AsymmetricKey
• 인증서
• SqlLogin
• WindowsGroup
• WindowsUser

현재 cmdlet은 ExternalUser 또는 ExternalGroup을 지원하지 않습니다.

매개 변수 속성

매개 변수 집합

-MustChangePasswordAtNextLogin

사용자가 다음 로그인 시 암호를 변경해야 임을 나타냅니다. 이 매개 변수는 SqlLogin 형식 개체만 적용합니다. 이 매개 변수는 EnforcePasswordExpiration 매개 변수를 의미합니다. 둘 다 지정할 필요는 없습니다.

매개 변수 속성

매개 변수 집합

-Path

이 cmdlet이 작업을 실행하는 SQL Server의 경로를 지정합니다. 기본값은 현재 작업 디렉터리입니다.

매개 변수 속성

매개 변수 집합

-Script

이 cmdlet이 이 cmdlet이 수행하는 작업을 수행하는 Transact-SQL 스크립트를 반환한다는 것을 나타냅니다.

매개 변수 속성

매개 변수 집합

-ServerInstance

SQL Server 인스턴스의 이름을 지정합니다. 기본 인스턴스의 경우 컴퓨터 이름을 지정합니다. 명명된 인스턴스의 경우 ComputerName\InstanceName 형식을 사용합니다.

매개 변수 속성

매개 변수 집합

-TrustServerCertificate

신뢰의 유효성을 검사하기 위해 인증서 체인을 건너뛰는 동안 채널이 암호화되는지 여부를 나타냅니다.

모듈의 v22에서 기본값은 $true v21과의 호환성을 위한 것입니다. 모듈의 v23+에서 기본값은 '$false'이며, 이로 인해 기존 스크립트에 대한 호환성이 손상되는 변경이 발생할 수 있습니다.

이 매개 변수는 모듈의 v22에서 새로 생성됩니다.

매개 변수 속성

매개 변수 집합

CommonParameters

입력

Microsoft.SqlServer.Management.Smo.Server

출력

System.Object

관련 링크

• Get-SqlLogin
• Remove-SqlLogin