Invoke-SqlAssessment
선택한 SQL Server 개체에 대한 SQL 평가 모범 사례 검사를 실행하고 결과를 반환합니다.
구문
Invoke-SqlAssessment
[-Check <Object[]>]
[[-InputObject] <PSObject>]
[-Configuration <PSObject>]
[-MinSeverity <SeverityLevel>]
[-FlattenOutput]
[-ProgressAction <ActionPreference>]
[<CommonParameters>] Description
Invoke-SqlAssessment cmdlet은 각 입력 개체에 대한 평가를 실행하고 지정된 개체에 적용해야 하는 모범 사례 권장 사항 목록을 반환합니다. 지정된 권장 사항을 따르는 것은 사용자의 달려 있습니다. 자세한 내용은 SQL 평가 API 개요참조하세요.
이 cmdlet은 다음 입력 형식을 허용합니다.
- Microsoft.SqlServer.Management.Smo.Server
- Microsoft.SqlServer.Management.Smo.Database
- Microsoft.SqlServer.Management.Smo.AvailabilityGroup
- Microsoft.SqlServer.Management.Smo.FileGroup
- Microsoft.SqlServer.Management.Smo.RegisteredServers.RegisteredServer
- 위 형식의 개체에 대한 경로가 포함된 문자열
- 개체 컬렉션
Get-SqlInstance 및 Get-SqlDatabase 같은 SqlServer cmdlet 또는 Get-Item 및 Get-ChildItem과 같은 기본 PowerShell cmdlet을 사용하여 입력 개체를 가져올 수 있습니다. 또한 cmdlet은 SQL Server PowerShell 공급자를 지원하므로 해당 경로에서 개체를 가져올 수 있습니다. 경로를 명시적으로 전달할 수 있으며, 그렇지 않으면 현재 경로가 사용됩니다.
선택한 개체에 대한 검사의 가용성은 SQL Server 버전, 플랫폼 및 개체 유형에 따라 다릅니다. 또한 tempdb 또는 master같은 특정 데이터베이스를 대상으로 하는 검사가 있습니다. 또한 -MinSeverity 및 -Check 매개 변수를 사용하여 태그, 이름 및 심각도별로 검사를 필터링할 수 있습니다.
Get-SqlAssessmentItem cmdlet을
cmdlet은 입력 개체에 적용 가능한 검사만 실행합니다. 예를 들어 데이터베이스 검사는 -Check 목록에 지정된 경우에도 SQL Server 인스턴스 또는 가용성 그룹에 대해 실행되지 않습니다.
사용자 지정 구성은 -Configuration 매개 변수를 사용하여 적용할 수 있습니다.
사용자 지정 예제는 Github
메모. 첫 번째 공개 미리 보기 Invoke-SqlAssessment CheckId 및 CheckName에 각각 Check의 ID와 DisplayName이 포함된 속성이 있는 AssessmentNote 개체를 반환했습니다. 두 번째 공개 미리 보기에서 두 속성은 훨씬 더 많은 데이터를 제공하는 단일 Check 속성으로 대체되었습니다. $note Invoke-SqlAssessment반환된 개체라고 가정하면 $note 대신 $note.Check.Id 확인의 ID에 액세스할 수 있습니다. CheckId 또는 $note 설명을 확인합니다. Check.Description입니다. -FlattenOutput 매개 변수를 사용하여 CheckId 및 CheckName을 사용하여 이전 형식의 결과를 가져올 수 있습니다. 또한 이 매개 변수는 Write-SqlTableData같은 일부 cmdlet과의 호환성을 유지하는 데 도움이 됩니다. 자세한 내용은 예제 12-14를 참조하세요.
Invoke-SqlAssessment cmdlet의 출력은 지정된 모든 SQL Server 개체에 대해 위반된 모범 사례 목록입니다.
Azure VM의 SQL Server 지원
SQL 평가 cmdlet을 사용하면 온-프레미스 SQL Server뿐만 아니라 Azure VM의 SQL Server와 관련된 규칙(가상 머신 구성에 대한 정보를 사용하는 규칙)을 사용하여 Azure VM의 SQL Server 인스턴스를 평가할 수 있습니다. 예를 들어 AzSqlVmSize 규칙은 Azure VM에서 SQL Server 인스턴스를 호스트하는 VM의 크기가 권장되는지 확인합니다.
이러한 규칙을 사용하려면 Azure PowerShell 모듈 사용하여 Azure에 연결하고 Az.ResourceGraph 모듈이 설치되어 있는지 확인합니다.
Azure VM 인스턴스의 SQL Server에 대해 SQL 평가를 호출하기 전에 Azure PowerShell 로그인합니다. 예제 16은 대화형 로그인 프로세스 및 구독 선택을 보여줍니다.
메모. PowerShell 세션 간에 유지되는 Azure 계정 연결을 사용할 수 있습니다. 즉, 한 세션에서 Connect-AzAccount 호출하고 나중에 이 명령을 생략할 수 있습니다. 그러나 현재 버전의 SQL 평가 cmdlet은 Az.ResourceGraph 모듈을 명시적으로 가져와야 합니다. Import-Module Az.ResourceGraph
예제
예제 1: 로컬 기본 인스턴스에 대한 평가 호출
PS:> Get-SqlInstance -ServerInstance localhost | Invoke-SqlAssessment
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources.
...이 예제에서는 현재 컴퓨터에서 실행되는 SQL Server의 기본 인스턴스에 대한 모든 모범 사례 권장 사항을 가져오는 방법을 보여 줍니다.
예제 2: PSProvider cmdlet을 사용하여 평가 호출
PS:> Get-Item SQLSERVER:\SQL\localhost\default | Invoke-SqlAssessment
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources.
...이 예제에서는 SQL Server의 기본 인스턴스에 대한 모든 모범 사례 권장 사항을 가져오는 방법을 보여 줍니다.
예제 3: PS 공급자 경로를 사용하여 평가 호출
PS:> Invoke-SqlAssessment SQLSERVER:\SQL\localhost\default
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources.
...이 예제에서는 SQL Server의 기본 인스턴스에 대한 모든 모범 사례 권장 사항을 가져오는 방법을 보여 줍니다.
예제 4: 사용자 지정 구성을 사용하여 평가 호출
PS:> Get-SqlInstance -ServerInstance '(local)' | Invoke-SqlAssessment -Configuration C:\profileA.json, C:\profileB.json
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi A custom rule violation detected. CustomRuleA Profile A 1.0
...이 예제에서는 사용자 지정 구성을 적용하여 수정된 모범 사례 권장 사항 집합을 가져오는 방법을 보여 줍니다. 사용자 지정 구성은 JSON 파일에 설명되어 있습니다. 사용자 지정 규칙 집합 profileA.json 및 profileB.json 일부 검사를 사용하지 않도록 설정했으며 몇 가지 새로운 검사가 도입되었습니다. profileA.json 새 검사 중 하나가 SQL Server 인스턴스의 현재 구성에 문제가 있는 것을 발견했습니다. Github의 SQL 평가 샘플 폴더 방문하여 사용자 지정 방법을 알아보세요.
예제 5: 모든 인스턴스에 대한 평가 호출
PS:> dir SQLSERVER:\SQL\localhost | Invoke-SqlAssessment
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources.
TargetPath : Server[@Name='LOCAL\INSTANCE1']
Sev. Message Check ID Origin
---- ------- -------- ------
Medi Product version 14.0.1000 is not the latest available. Keep your LatestCU Microsoft Ruleset 0.1.202
your SQL Server up to date and install Service Packs and
Cumulative Updates as they are released.
...이 예제에서는 파이프라인을 통해 SQL Server 인스턴스 집합을 수락하는 Invoke-SqlAssessment cmdlet을 보여 줍니다.
예제 6: 필터링된 집합 ot tragets에 대한 평가 실행
PS:> Get-SqlInstance -ServerInstance . | Where { $_.Name -Match '.*\d+' } | Invoke-SqlAssessment
TargetPath : Server[@Name='LOCAL\INSTANCE1']
Sev. Message Check ID Origin
---- ------- -------- ------
Medi Product version 14.0.1000 is not the latest available. Keep your LatestCU Microsoft Ruleset 0.1.202
your SQL Server up to date and install Service Packs and
Cumulative Updates as they are released.
...이 예제에서는 파이프라인을 통해 SQL Server 인스턴스 집합을 수락하는 Invoke-SqlAssessment cmdlet을 보여 줍니다. 이 집합은 표준 PowerShell Where-Object cmdlet으로 필터링됩니다.
예제 7: 이름으로 데이터베이스에 대한 평가 호출
PS:> Get-SqlDatabase master -ServerInstance localhost | Invoke-SqlAssessment -Verbose
VERBOSE: Base ruleset version: 0.2.
VERBOSE: No recommendations for [master].이 예제에서는 데이터베이스의 이름을 수락하는 Invoke-SqlAssessment cmdlet을 보여 줍니다. 이 경우 문제를 찾을 수 없습니다.
예제 8: 경로별 데이터베이스에 대한 평가 호출
PS:> Invoke-SqlAssessment SQLSERVER:\SQL\localhost\default\Databases\master -Verbose
VERBOSE: Base ruleset version: 0.2.
VERBOSE: No recommendations for [master].이 예제에서는 sql Server 데이터베이스에 대한 경로를 수락하는 Invoke-SqlAssessment cmdlet을 보여 줍니다.
예제 9: 데이터베이스에 대한 높은 문제 검색
PS:> cd SQLSERVER:\SQL\localhost\default\Databases\master
PS:> Invoke-SqlAssessment -MinSeverity High
VERBOSE: Base ruleset version: 0.2.
VERBOSE: No recommendations for [master].이 예제에서는 현재 위치를 평가하는 Invoke-SqlAssessment cmdlet을 보여 줍니다. 높은 문제만 보고됩니다.
예제 10: 태그로 선택한 검사 실행
PS:> Get-SqlInstance -ServerInstance . | Invoke-SqlAssessment -Check Backup -Verbose
VERBOSE: Base ruleset version: 0.2.
VERBOSE: No recommendations for [LOCAL].이 예제에서는 로컬 서버의 모든 SQL Server 인스턴스에 대한 모든 백업 관련 검사를 실행하는 Invoke-SqlAssessment cmdlet을 보여 줍니다.
예제 11: 대화형으로 선택한 검사 실행
PS:> $serverInstance = Get-SqlInstance -ServerInstance '(local)'
PS:> $checks = Get-SqlAssessmentItem $serverInstance | Select Name, Description | Out-GridView -PassThru
PS:> Invoke-SqlAssessment $serverInstance -Check $checks
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.이 예제의 두 번째 줄에서는 $serverInstance 대한 검사를 가져오고 그 중 일부를 대화형으로 선택하는 방법을 보여줍니다. 선택한 항목은 배열 변수에 저장되며 Invoke-SqlAssessment cmdlet에 대한 입력으로 사용됩니다. 선택한 검사만 평가 프로세스 중에 실행됩니다.
예제 12: -FlattenOutput 매개 변수의 효과
PS> $inst = Get-SqlInstance -ServerInstance .
PS> Invoke-SqlAssessment $inst -FlattenOutput | Select -First 1 | Get-Member
TypeName: Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNoteFlat
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
CheckId Property string CheckId {get;}
CheckName Property string CheckName {get;}
HelpLink Property string HelpLink {get;}
Message Property string Message {get;}
RulesetName Property string RulesetName {get;}
RulesetVersion Property string RulesetVersion {get;}
Severity Property string Severity {get;}
TargetPath Property string TargetPath {get;}
TargetType Property string TargetType {get;}
PS> Invoke-SqlAssessment $inst | Select -First 1 | Get-Member
TypeName: Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNote
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
Check Property Microsoft.SqlServer.Management.Assessment.Checks.ICheck Check {get;}
HelpLink Property string HelpLink {get;}
Message Property string Message {get;}
Severity Property Microsoft.SqlServer.Management.Assessment.SeverityLevel Severity {get;}
TargetPath Property string TargetPath {get;}
TargetType Property string TargetType {get;}
PS> (Invoke-SqlAssessment $inst | Select -First 1).Check | Get-Member
TypeName: Microsoft.SqlServer.Management.Assessment.Checks.Check
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
Condition Property Microsoft.SqlServer.Management.Assessment....
Description Property string Description {get;set;}
DisplayName Property string DisplayName {get;set;}
Enabled Property bool Enabled {get;set;}
HelpLink Property string HelpLink {get;set;}
Id Property string Id {get;set;}
Level Property Microsoft.SqlServer.Management.Assessment....
Message Property string Message {get;set;}
OriginName Property string OriginName {get;set;}
OriginVersion Property version OriginVersion {get;set;}
Parameters Property System.Collections.Generic.IDictionary[str...
Probes Property System.Collections.Generic.List[Microsoft....
Tags Property System.Collections.Generic.HashSet[string]...
Target Property Microsoft.SqlServer.Management.Assessment....이 예제에서는 -FlattenOutput 매개 변수를 사용하거나 사용하지 않고 반환된 개체의 차이점을 보여 있습니다. 이 매개 변수는 거대한 복합 Check 개체를 CheckId 및 CheckName의 두 문자열 속성으로 바꿉니다. 직렬화 용도로 유용합니다(다음 예제 참조).
첫 번째 명령은 문자열 형식의 모든 속성을 가진 단순 개체를 표시합니다.
두 번째 명령은 문자열이 아닌 두 가지 속성인 Check 및 Severity를 가진 다른 개체를 보여 있습니다.
세 번째 명령은 Check 속성으로 액세스할 수 있는 풍부한 데이터 집합을 보여줍니다.
예제 13: 실패한 검사를 다시 실행
PS> $inst = Get-SqlInstance -ServerInstance .
PS> $results = Invoke-SqlAssessment $inst
PS> $results
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources.
PS> $results[1].Check.Description
This check detects deprecated or discontinued features used on target SQL Server instance. Deprecated features may be
removed in a future release of SQL Server. Discontinued features have been removed from specific versions of SQL Server.
PS> Invoke-SqlAssessment $inst -Check $results[1].Check
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
PS> Invoke-SqlAssessment $inst -Check ($results).Check
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources.이 예제에서는 평가 결과와 함께 반환된 검사를 다시 사용하는 방법을 보여 줍니다. 이전에 AssessmentNotes를 생성한 검사를 다시 실행할 수 있습니다.
예제 14: 평가 결과를 테이블에 저장
PS:> $serverInstance = Get-SqlInstance -ServerInstance '(local)'
PS:> Invoke-SqlAssessment $serverInstance -FlattenOutput |
Write-SqlTableData -ServerInstance localhost -DatabaseName SqlAssessment -SchemaName Assessment -TableName Results -Force이 예제의 두 번째 줄에서는 Write-SqlTableData cmdlet과 함께 -FlattenOutput 매개 변수를 사용하여 평가 결과를 SQL 데이터베이스에 저장하는 방법을 보여 줍니다.
예제 15: 명시적으로 자격 증명 지정
PS> $cred = Get-Credential
PowerShell credential request
Enter your credentials.
User: Administrator
Password for user Administrator: ********
PS> $inst = Get-SqlInstance -ServerInstance 10.0.3.118 -Credential $cred
PS> Invoke-SqlAssessment $inst
TargetPath : Server[@Name='ContosSQL']
Sev. Message Check ID Origin
---- ------- -------- ------
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources이 예제에서는 명시적으로 지정된 자격 증명을 사용하여 SQL 평가를 호출하는 방법을 보여 줍니다.
예제 16: Azure VM 인스턴스에서 SQL Server에 대한 평가 호출
PS> Connect-AzAccount
PS> Set-Subscription My-Pay-As-You-Go
PS> $cred = Get-Credential
PowerShell credential request
Enter your credentials.
User: Administrator
Password for user Administrator: ********
PS> $inst = Get-SqlInstance -ServerInstance 10.0.3.118 -Credential $cred
PS> Invoke-SqlAssessment $inst
TargetPath : Server[@Name='ContosoAzureSQL']
Sev. Message Check ID Origin
---- ------- -------- ------
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources
Info Use memory optimized virtual machine sizes for the best AzSqlVmSize Microsoft Ruleset 0.1.202
performance of SQL Server workloads이 예제에서는 Azure VM 인스턴스에서 SQL Server에 대한 평가를 호출하는 방법을 보여 줍니다.
활성 Azure 구독 연결을 사용하면 Azure VM에서 SQL Server 관련 검사를 수행할 수 있습니다(이 예제에서는 AzSqlVmSize). 첫 번째 줄은 Azure 계정에 연결하여 Azure Resource Graph에서 데이터를 가져옵니다. 두 번째 줄은 선택 사항입니다.
이러한 검사를 실행하려면 SQL 평가에 Az.ResourceGraph 모듈이 필요합니다.
매개 변수
-Check
하나 이상의 검사, ID 또는 태그를 확인합니다.
모든 검사 개체에 대해 invoke-SqlAssessment 실행하여 입력 개체를 지원하는지 확인합니다.
모든 확인 ID에 대해 Invoke-SqlAssessment 입력 개체를 지원하는 경우 해당 검사를 실행합니다.
태그의 경우 invoke-SqlAssessment
| 형식: | Object[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Configuration
사용자 지정 구성을 포함하는 파일의 경로를 지정합니다. 사용자 지정 파일은 지정된 순서로 기본 구성에 적용됩니다. 범위는 이 cmdlet 호출로만 제한됩니다.
| 형식: | PSObject |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-FlattenOutput
이 cmdlet은 Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNote
Invoke-SqlAssessment 반환된 일반 AssessmentNote에는 Check와 같은 다른 유용한 복합 개체에 대한 참조가 포함되어 있습니다(예제 12 참조). Check 속성을 사용하면 확인의 설명을 얻거나 검사를 다시 사용할 수 있습니다(예제 13 참조). 그러나 일부 cmdlet은 복잡한 속성을 지원하지 않습니다. 예를 들어 Write-SqlTableData 데이터베이스에 AssessmentNote를 쓰려고 하는 동안 오류가 발생합니다. 이를 방지하려면 -FlattenOutput 매개 변수를 사용하여 Check 속성을 CheckId 및 CheckName이라는 두 개의 간단한 문자열로 바꿀 수 있습니다(예제 14 참조).
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
SQL Server 개체 또는 이러한 개체의 경로를 지정합니다. cmdlet은 이 개체에 대한 평가를 실행합니다. 이 매개 변수를 생략하면 현재 위치가 입력 개체로 사용됩니다. 현재 위치가 지원되는 SQL Server 개체가 아니면 cmdlet에서 오류를 알 수 있습니다.
| 형식: | PSObject |
| 별칭: | Target |
| Position: | 10 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-MinSeverity
검사를 찾을 수 있는 최소 심각도 수준을 지정합니다. 예를 들어 높음이 -MinSeverity 경우 낮음, 중간 또는 정보 수준에 대한 검사는 반환되지 않습니다.
| 형식: | SeverityLevel |
| 별칭: | Severity |
| 허용되는 값: | Information, Low, Medium, High |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ProgressAction
powerShell이 스크립트, cmdlet 또는 공급자(예: Write-Progress cmdlet에서 생성된 진행률 표시줄)에 의해 생성된 진행률 업데이트에 응답하는 방법을 결정합니다. Write-Progress cmdlet은 명령의 상태를 표시하는 진행률 표시줄을 만듭니다.
| 형식: | ActionPreference |
| 별칭: | proga |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
System.String[]
Microsoft.SqlServer.Management.Smo.SqlSmoObject[]
출력
Microsoft.SqlServer.Assessment.Cmdlets.AssessmentNote