Set-SqlErrorLog

구문

ByPath (기본값)

Set-SqlErrorLog
    [[-Path] <String>]
    [-MaxLogCount <UInt16>]
    [-ErrorLogSizeKb <Int32>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [<CommonParameters>]

ByName

Set-SqlErrorLog
    [[-ServerInstance] <String[]>]
    [-Credential <PSCredential>]
    [-ConnectionTimeout <Int32>]
    [-MaxLogCount <UInt16>]
    [-ErrorLogSizeKb <Int32>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [<CommonParameters>]

ByObject

Set-SqlErrorLog
    [-InputObject] <Server>
    [-MaxLogCount <UInt16>]
    [-ErrorLogSizeKb <Int32>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [<CommonParameters>]

Description

예제

예제 1: 최대 수 또는 오류 로그 설정

PS C:\> Set-SqlErrorLog -ServerInstance "MyServer\MyInstance" -MaxLogCount 11 | Out-Null

예제 2: TSQL 스크립트 코드를 반환하여 최대 수 또는 오류 로그 설정

PS C:\> Set-SqlErrorLog -ServerInstance "MyServer\MyInstance" -MaxLogCount 11 -Script

USE [master]
GO
EXEC xp_instance_regwrite N'HKEY_LOCAL_MACHINE', N'Software\Microsoft\MSSQLServer\MSSQLServer', N'NumErrorLogs', REG_DWORD, 11
GO

매개 변수

-AccessToken

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

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

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

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

매개 변수 속성

매개 변수 집합

-ConnectionTimeout

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

매개 변수 속성

매개 변수 집합

-Credential

이 작업을 수행할 수 있는 권한이 있는 SQL Server 로그인의 자격 증명을 지정하는 데 사용되는 PSCredential 개체를 지정합니다.

매개 변수 속성

매개 변수 집합

-Encrypt

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

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

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

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

매개 변수 속성

매개 변수 집합

-ErrorLogSizeKb

SQL 인스턴스 오류 로그 파일의 크기 제한을 킬로바이트 단위로 지정합니다.

유효한 범위는 Int32.MaxValue까지 0입니다.

사용자가 이 매개 변수를 지정하지 않으면 ErrorLogSizeKb는 변경되지 않은 상태로 유지됩니다. SQL 인스턴스의 기본값은 0입니다.

매개 변수 속성

매개 변수 집합

-HostNameInCertificate

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

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

매개 변수 속성

매개 변수 집합

-InputObject

대상 인스턴스의 서버 개체를 지정합니다.

매개 변수 속성

매개 변수 집합

-MaxLogCount

최대 오류 로그 파일 수를 지정합니다. 값을 지정하지 않으면 cmdlet은 값을 기본값으로 다시 설정합니다.

허용되는 값 범위는 6에서 99 사이입니다.

매개 변수 속성

매개 변수 집합

-Path

이 cmdlet이 작업을 실행하는 SQL Server 인스턴스의 경로를 지정합니다. 이 매개 변수의 값을 지정하지 않으면 cmdlet에서 작업 위치를 사용합니다.

매개 변수 속성

매개 변수 집합

-Script

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

매개 변수 속성

매개 변수 집합

-ServerInstance

문자열 배열로 SQL Server 인스턴스의 이름을 지정합니다. 기본 인스턴스의 경우 컴퓨터 이름인 MyComputer만 지정합니다. 명명된 인스턴스의 경우 형식 MyComputer\MyInstanceName을 사용합니다.

매개 변수 속성

매개 변수 집합

-TrustServerCertificate

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

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

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

매개 변수 속성

매개 변수 집합

CommonParameters

입력

System.String

Microsoft.SqlServer.Management.Smo.Server

참고

관련 링크

• Get-SqlErrorLog