Remove-SqlLogin

구문

ByPath (기본값)

Remove-SqlLogin
    [[-Path] <String>]
    [-LoginName <String[]>]
    [-RemoveAssociatedUsers]
    [-Force]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

Remove-SqlLogin
    [-InputObject] <Login>
    [-LoginName <String[]>]
    [-RemoveAssociatedUsers]
    [-Force]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByName

Remove-SqlLogin
    [[-ServerInstance] <String[]>]
    [-LoginName <String[]>]
    [-RemoveAssociatedUsers]
    [-Force]
    [-Credential <PSCredential>]
    [-ConnectionTimeout <Int32>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

예제

예제 1: 이름으로 로그인 개체 제거

PS C:\> Get-SqlLogin -ServerInstance "MyServerInstance" -LoginName "Login01" | Remove-SqlLogin

예제 2: 문자열과 일치하는 개체 제거

PS C:\> Get-SqlLogin -ServerInstance "MyServerInstance" -LoginName 'Login.*' -Regex | Remove-SqlLogin -RemoveAssociatedUsers

예제 3: 여러 로그인 개체 제거

PS C:\> Remove-Login -ServerInstance "MyServerInstance" -LoginName "login01","login02","login03"

매개 변수

-AccessToken

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

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

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

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

매개 변수 속성

매개 변수 집합

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

매개 변수 집합

-ConnectionTimeout

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

매개 변수 속성

매개 변수 집합

-Credential

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

매개 변수 속성

매개 변수 집합

-Encrypt

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

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

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

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

매개 변수 속성

매개 변수 집합

-Force

사용자 확인을 요청하지 않고 명령을 강제로 실행합니다.

매개 변수 속성

매개 변수 집합

-HostNameInCertificate

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

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

매개 변수 속성

매개 변수 집합

-InputObject

이 cmdlet에서 제거하는 로그인 개체를 나타내는 SMO(SQL Server Management Objects) 개체를 지정합니다.

매개 변수 속성

매개 변수 집합

-LoginName

이 cmdlet에서 제거하는 로그인 개체의 이름 배열을 지정합니다.

참고: 대/소문자 구분은 SQL Server 인스턴스와 동일합니다.

매개 변수 속성

매개 변수 집합

-Path

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

매개 변수 속성

매개 변수 집합

-RemoveAssociatedUsers

이 cmdlet은 로그인 개체와 연결된 사용자를 제거한다는 것을 나타냅니다.

매개 변수 속성

매개 변수 집합

-Script

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

매개 변수 속성

매개 변수 집합

-ServerInstance

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

매개 변수 속성

매개 변수 집합

-TrustServerCertificate

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

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

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

매개 변수 속성

매개 변수 집합

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

매개 변수 집합

CommonParameters

입력

Microsoft.SqlServer.Management.Smo.Login

System.String

관련 링크

• Add-SqlLogin
• Get-SqlLogin