Get-SqlErrorLog

참조

모듈:: SQLServer

SQL Server 오류 로그를 가져옵니다.

Syntax

Get-SqlErrorLog
   [-Timespan <TimeSpan>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Since <SinceType>]
   [-Ascending]
   [[-Path] <String[]>]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [<CommonParameters>]

Get-SqlErrorLog
   [-Timespan <TimeSpan>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Since <SinceType>]
   [-Ascending]
   [[-ServerInstance] <String[]>]
   [-Credential <PSCredential>]
   [-ConnectionTimeout <Int32>]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [<CommonParameters>]

Get-SqlErrorLog
   [-Timespan <TimeSpan>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Since <SinceType>]
   [-Ascending]
   [-InputObject] <Server[]>
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [<CommonParameters>]

Description

Get-SqlErrorLog cmdlet은 SQL Server 오류 로그를 가져옵니다.

이 cmdlet은 오류 로그를 가져오는 다음 작업 모드를 지원합니다.

SQL Server instance 전달합니다.
SQL Server instance Path 매개 변수를 지정합니다.
유효한 컨텍스트에서 cmdlet을 호출합니다.

예제

예제 1: 검색 단어가 있는 특정 시간 프레임에서 생성된 모든 로그 가져오기

PS C:\> CD SQLSERVER:\SQL\MyServer\MyInstance
PS SQLSERVER:\SQL\MyServer\MyInstance> Get-SqlErrorLog -Since Yesterday  | Where-Object { $_.Text -match 'Error' } | Format-Table

Date                 Source Text                                  ArchiveNo ServerInstance
----                 ------ ----                                  --------- --------------
6/16/2016 6:04:20 PM Logon  Error: 17828, Severity: 20, State: 4.         0 MyServer\MyInstance

첫 번째 명령은 디렉터리를 SQL Server instance 변경합니다.

예제 2: 특정 시간 프레임에서 생성된 모든 로그 가져오기

PS C:\> CD SQLSERVER:\SQL\MyServer\MyInstance
PS SQLSERVER:\SQL\MyServer\MyInstance> Get-SqlErrorLog -Timespan '05:30:00' | Format-Table

Date                  Source  Text
----                  ------  ----
6/17/2016 12:00:00 AM spid26s This instance of SQL Server has been using a process ID of 21520 since 6/10/2016 3:56:... 
6/16/2016 6:04:20 PM  Logon   The prelogin packet used to open the connection is structurally invalid; the connectio... 
6/16/2016 6:04:20 PM  Logon   Error: 17828, Severity: 20, State: 4.

첫 번째 명령은 디렉터리를 SQL Server instance 변경합니다.

예제 3: 특정 시간 프레임에서 생성된 모든 로그를 오름차순으로 정렬하고 그룹화합니다.

PS C:\> CD SQLSERVER:\SQL\MyServer
PS SQLSERVER:\SQL\MyServer> ls | Get-SqlErrorLog -After '2016-05-10' -Before '2016-06-18' -Ascending | ? { $_.Text -match 'Login failed' } | Group-Object -Property ServerInstance

Count Name                      Group
----- ----                      -----
    1 MyServer                  {{ Date = 6/17/2016 2:00:04 AM, Source = Logon, Text = Login failed for user ... 
    2 MyServer\INST1            {{ Date = 6/10/2016 3:58:46 PM, Source = Logon, Text = Login failed for user

첫 번째 명령은 디렉터리를 SQL Server instance 변경합니다.

매개 변수

-AccessToken

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

예를 들어 또는 에 연결 SQL Azure DB 하고 를 사용하는 Service Principal 데 사용할 수 있습니다Managed IdentitySQL Azure Managed Instance.

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

이 매개 변수는 모듈의 v22에서 새로 추가되었습니다.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-After

이 cmdlet은 지정된 시간 후에 생성된 오류 로그만 가져오게 지정합니다.

Before 매개 변수를 지정하면 이 cmdlet은 지정된 앞에 생성된 모든 오류 로그를 가져옵니다.

Since 또는 Timespan 매개 변수를 사용하려는 경우 이 매개 변수를 지정하지 마세요.

형식은 .Net System.DataTime.Parse()의 규칙에 따라 정의됩니다.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Ascending

cmdlet이 오류 로그 컬렉션을 로그 날짜별로 오름차순으로 정렬한다는 것을 나타냅니다. 이 매개 변수를 지정하지 않으면 cmdlet은 오류 로그를 내림차순으로 정렬합니다.

이 cmdlet이 여러 원본에 오류 로그를 가져오면 정렬이 동일한 원본의 모든 오류 로그에 적용됩니다. 이 cmdlet이 가져오는 로그는 먼저 원본별로 그룹화된 다음 로그 날짜별로 정렬됩니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Before

이 cmdlet은 지정된 시간 이전에 생성된 오류 로그만 가져오게 지정합니다.

After 매개 변수를 지정하면 cmdlet이 기본값으로 설정됩니다. 즉, cmdlet은 현재 시간까지 이 매개 변수에 대해 지정한 후 생성된 모든 오류 로그를 가져옵니다.

Since 또는 Timespan 매개 변수를 사용하려는 경우 이 매개 변수의 값을 지정하지 마세요. 형식은 .Net System.Datatime.Parse()의 규칙에 따라 정의됩니다.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionTimeout

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Encrypt

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

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

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

이 매개 변수는 모듈의 v22에서 새로 추가되었습니다.

Type:	String
Accepted values:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostNameInCertificate

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

이 매개 변수는 모듈의 v22에서 새로 추가되었습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

이 cmdlet에서 로그를 가져오는 대상 instance 서버 개체를 배열로 지정합니다.

Type:	Server[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

이 cmdlet이 작업을 실행하는 SQL Server instance 대한 경로를 배열로 지정합니다. 이 매개 변수의 값을 지정하지 않으면 cmdlet은 현재 작업 위치를 사용합니다.

Type:	String[]
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerInstance

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

Type:	String[]
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Since

Timespan 매개 변수의 약어를 지정합니다.

After 또는 Before 매개 변수를 사용하려는 경우 이 매개 변수를 지정하지 마세요.

이 매개 변수에 허용되는 값은 다음과 같습니다.

자정(자정 이후에 생성된 모든 로그를 가져옵니다.)
어제(지난 24시간 동안 생성된 모든 로그를 가져옵니다).
LastWeek(지난 주에 생성된 모든 로그를 가져옵니다.)
LastMonth(지난 달에 생성된 모든 로그를 가져옵니다.)

Type:	SinceType
Accepted values:	Midnight, Yesterday, LastWeek, LastMonth
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Timespan

이 cmdlet이 시간 범위를 벗어난 오류 로그에서 필터링하는 TimeSpan 개체를 지정합니다.

이 매개 변수의 형식은 d.HH:mm:ss입니다.

Since, After 또는 Before 매개 변수를 사용하는 경우 이 매개 변수는 무시됩니다.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustServerCertificate

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

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

이 매개 변수는 모듈의 v22에서 새로 추가되었습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

입력

System.String[]

Microsoft.SqlServer.Management.Smo.Server[]

Set-SqlErrorLog

Get-SqlErrorLog

Syntax

Description

예제

예제 1: 검색 단어가 있는 특정 시간 프레임에서 생성된 모든 로그 가져오기

예제 2: 특정 시간 프레임에서 생성된 모든 로그 가져오기

예제 3: 특정 시간 프레임에서 생성된 모든 로그를 오름차순으로 정렬하고 그룹화합니다.

매개 변수

-AccessToken

-After

-Ascending

-Before

-ConnectionTimeout

-Credential

-Encrypt

-HostNameInCertificate

-InputObject

-Path

-ServerInstance

-Since

-Timespan

-TrustServerCertificate

입력

관련 링크

추가 리소스