Invoke-SqlAssessment

Ссылка

Модуль:: SQLServer

Выполняет рекомендации по оценке SQL для выбранного объекта SQL Server и возвращает результаты.

Синтаксис

Invoke-SqlAssessment
      [-Check <Object[]>]
      [[-InputObject] <PSObject>]
      [-Configuration <PSObject>]
      [-MinSeverity <SeverityLevel>]
      [-FlattenOutput]
      [-ProgressAction <ActionPreference>]
      [<CommonParameters>]

Описание

Командлет Invoke-SqlAssessment выполняет оценку для каждого входного объекта и возвращает список рекомендаций, которые следует применить к указанным объектам. Это до вас, чтобы следовать заданным рекомендациям или нет. Дополнительные сведения см. вAPI оценки SQL.

Этот командлет принимает следующие типы входных данных:

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.RegisteredServers.RegisteredServer
Строка, содержащая путь к любому объекту из указанных выше типов
Коллекция объектов

Объекты ввода можно получить с помощью командлетов SqlServer, таких как Get-SqlInstance и Get-SqlDatabase или базовые командлеты PowerShell, такие как Get-Item и Get-ChildItem. Кроме того, командлет поддерживает поставщик SQL Server PowerShell, чтобы он смог получить объект из своего пути. Путь можно передать явно, в противном случае будет использоваться текущий путь.

Доступность проверки выбранного объекта зависит от версии, платформы и типа объектов SQL Server. Кроме того, существуют проверки, предназначенные для конкретных баз данных, таких как tempdb или master. Кроме того, можно фильтровать проверки по тегам, именам и серьезности с помощью параметров -MinSeverity и -Check.

Список проверок, применимых к указанному объекту SQL Server, можно получить с помощью командлета Get-SqlAssessmentItem.

Командлет выполняет только проверки, применимые только к входным объектам. Например, проверки базы данных не будут выполняться для экземпляра SQL Server или группы доступности, даже если они указаны в списке -Check.

Пользовательские конфигурации можно применить с параметром -Configuration. Примеры настройки доступны наGithub.

ЗАМЕТКА. В первой общедоступной предварительной версии Invoke-SqlAssessment возвращены объекты AssessmentNote со свойствами CheckId и CheckName, содержащими идентификатор check и DisplayName соответственно. Во втором общедоступном предварительном просмотре два свойства были заменены одним свойством Check, предоставляющим гораздо больше данных. Предполагая, что $note был объектом, возвращенным Invoke-SqlAssessment, можно получить доступ к идентификатору проверки как $note.Check.Id вместо $note. CheckId или описание check как $note. Check.Description. Вы можете использовать параметр -FlattenOutput для получения результатов в предыдущем формате с помощью CheckId и CheckName. Этот параметр также поможет сохранить совместимость с некоторыми командлетами, такими как Write-SqlTableData. Дополнительные сведения см. в примерах 12-14.

Invoke-SqlAssessment выходные данные командлета — это список нарушенных рекомендаций для каждого заданного объекта SQL Server. Используйте свойство Description, чтобы узнать о рекомендациях и свойстве Message, чтобы узнать, как его можно решить. Кроме того, каждый результат проверки содержит ссылку на онлайн-документацию, которая поможет вам лучше определить проблему.

Поддержка SQL Server на виртуальной машине Azure

С помощью командлетов оценки SQL можно оценить экземпляр SQL Server на виртуальной машине Azure не только как локальный SQL Server, но и правила, относящиеся к SQL Server на виртуальной машине Azure (которые используют сведения о конфигурации виртуальной машины). Например, правило AzSqlVmSize проверяет, что виртуальная машина, на котором размещен экземпляр SQL Server на виртуальной машине Azure, имеет рекомендуемый размер.

Чтобы использовать такие правила, подключитесь к Azure с модуля Azure PowerShell и убедитесь, что модуль Az.ResourceGraph.

войдите с помощью Azure PowerShell перед вызовом оценки SQL Server на экземпляре виртуальной машины Azure. В примере 16 показан интерактивный процесс входа и выбор подписки.

ЗАМЕТКА. Можно использовать подключение учетной записи Azure, сохраняемое между сеансами PowerShell, т. е. вызывать Connect-AzAccount в одном сеансе и пропускать эту команду позже. Однако текущая версия командлетов оценки SQL требует, чтобы модуль 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

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. Перейдите к папке примеров оценки SQL на сайте Github, чтобы узнать, как выполнить настройку.

Пример 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.
...

В этом примере показано, как Invoke-SqlAssessment командлет, принимаюющий набор экземпляров SQL Server через конвейер.

Пример 6. Запуск оценки для отфильтрованного набора от 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.
...

В этом примере показано, как Invoke-SqlAssessment командлет, принимаюющий набор экземпляров SQL Server через конвейер. Набор фильтруется с помощью стандартного командлета PowerShell Where-Object.

Пример 7. Вызов оценки для базы данных по имени

PS:> Get-SqlDatabase master -ServerInstance localhost | Invoke-SqlAssessment -Verbose
VERBOSE: Base ruleset version: 0.2.
VERBOSE: No recommendations for [master].

В этом примере показано, как Invoke-SqlAssessment командлет, принимаюющий имя базы данных. В этом случае проблема не найдена.

Пример 8. Вызов оценки для базы данных по пути

PS:> Invoke-SqlAssessment SQLSERVER:\SQL\localhost\default\Databases\master -Verbose
VERBOSE: Base ruleset version: 0.2.
VERBOSE: No recommendations for [master].

В этом примере показано, как Invoke-SqlAssessment, принимающие путь к базе данных SQL Server.

Пример 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 командлет оценивает текущее расположение. Сообщается только о высоких проблемах.

Пример 10. Выполнение проверок, выбранных по тегу

PS:> Get-SqlInstance -ServerInstance . | Invoke-SqlAssessment -Check Backup -Verbose
VERBOSE: Base ruleset version: 0.2.
VERBOSE: No recommendations for [LOCAL].

В этом примере показан командлет Invoke-SqlAssessment, на котором выполняются все проверки, связанные с резервным копированием, для каждого экземпляра SQL Server на локальном сервере.

Пример 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. Во время оценки выполняются только выбранные проверки.

Пример 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.

Пример 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

Вторая строка этого примера показывает использование параметра -FlattenOutput с командлетом Write-SqlTableData для хранения результатов оценки в базе данных 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. Вызов оценки для SQL Server на экземпляре виртуальной машины Azure

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

В этом примере показано, как вызвать оценку для sql Server в экземпляре виртуальной машины Azure.

Активное подключение к подписке Azure включает проверки, связанные с виртуальными машинами Azure (AzSqlVmSize в этом примере). Первая строка подключается к учетной записи Azure для получения данных из Azure Resource Graph. Вторая строка является необязательной.

Для выполнения этих проверок для оценки SQL требуется модуль Az.ResourceGraph.

Параметры

-Check

Одна или несколько проверок, проверка идентификаторов или тегов.

Для каждого проверяемого объекта Invoke-SqlAssessment выполняется, чтобы проверить, поддерживает ли он входной объект.

Для каждого идентификатора проверки Invoke-SqlAssessment выполняет соответствующую проверку, поддерживает ли он входной объект.

Для тегов Invoke-SqlAssessment выполняет проверки с любым из этих тегов.

Тип:	Object[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Configuration

Задает пути к файлам, содержащим настраиваемую конфигурацию. Файлы настройки будут применяться к конфигурации по умолчанию в указанном порядке. Область ограничена только вызовом этого командлета.

Тип:	PSObject
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FlattenOutput

Указывает, что этот командлет создает простые объекты типа Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNoteFlat вместо Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNote.

Regular AssessmentNote, возвращаемый из Invoke-SqlAssessment, содержит ссылки на другие полезные сложные объекты, такие как Check (см. пример 12). С помощью свойства Check можно получить описание проверки или повторно использовать проверку (см. пример 13). Но некоторые командлеты не поддерживают сложные свойства. Например, Write-SqlTableData вызовет ошибку при попытке записи AssessmentNote в базу данных. Чтобы избежать этого, можно использовать параметр -FlattenOutput для замены свойства Check двумя простыми строками: CheckId и CheckName (см. пример 14).

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

Указывает объект SQL Server или путь к такому объекту. Командлет выполняет оценку для этого объекта. Если этот параметр опущен, текущее расположение используется в качестве входного объекта. Если текущее расположение не является поддерживаемым объектом SQL Server, командлет сигнализирует об ошибке.

Тип:	PSObject
Aliases:	Target
Position:	10
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-MinSeverity

Указывает минимальный уровень серьезности для найденных проверок. Например, проверки низких, средних или информационных уровней не будут возвращены, когда -MinSeverity High.

Тип:	SeverityLevel
Aliases:	Severity
Допустимые значения:	Information, Low, Medium, High
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ProgressAction

Определяет, как PowerShell реагирует на обновления хода выполнения, созданные скриптом, командлетом или поставщиком, например индикаторами хода выполнения, созданными командлетом Write-Progress. Командлет Write-Progress создает индикаторы хода выполнения, показывающие состояние команды.

Тип:	ActionPreference
Aliases:	proga
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

System.String[]

Microsoft.SqlServer.Management.Smo.SqlSmoObject[]

Выходные данные

Microsoft.SqlServer.Assessment.Cmdlets.AssessmentNote

Поделиться через

Invoke-SqlAssessment

Синтаксис

Описание

Примеры

Пример 1. Вызов оценки для локального экземпляра по умолчанию

Пример 2. Вызов оценки с помощью командлета PSProvider

Пример 3. Вызов оценки с помощью пути поставщика PS

Пример 4. Вызов оценки с пользовательской конфигурацией

Пример 5. Вызов оценки для всех экземпляров

Пример 6. Запуск оценки для отфильтрованного набора от tragets

Пример 7. Вызов оценки для базы данных по имени

Пример 8. Вызов оценки для базы данных по пути

Пример 9. Обнаружение высоких проблем для базы данных

Пример 10. Выполнение проверок, выбранных по тегу

Пример 11. Выполнение интерактивных проверок

Пример 12. Эффект параметра -FlattenOutput

Пример 13. Повторное выполнение проверок сбоем

Пример 14. Хранение результатов оценки в таблице

Пример 15. Явное указание учетных данных

Пример 16. Вызов оценки для SQL Server на экземпляре виртуальной машины Azure

Параметры

-Check

-Configuration

-FlattenOutput

-InputObject

-MinSeverity

-ProgressAction

Входные данные

Выходные данные

Обратная связь

Обратная связь

Дополнительные ресурсы

Поделиться через

Invoke-SqlAssessment

Синтаксис

Описание

Примеры

Пример 1. Вызов оценки для локального экземпляра по умолчанию

Пример 2. Вызов оценки с помощью командлета PSProvider

Пример 3. Вызов оценки с помощью пути поставщика PS

Пример 4. Вызов оценки с пользовательской конфигурацией

Пример 5. Вызов оценки для всех экземпляров

Пример 6. Запуск оценки для отфильтрованного набора от tragets

Пример 7. Вызов оценки для базы данных по имени

Пример 8. Вызов оценки для базы данных по пути

Пример 9. Обнаружение высоких проблем для базы данных

Пример 10. Выполнение проверок, выбранных по тегу

Пример 11. Выполнение интерактивных проверок

Пример 12. Эффект параметра -FlattenOutput

Пример 13. Повторное выполнение проверок сбоем

Пример 14. Хранение результатов оценки в таблице

Пример 15. Явное указание учетных данных

Пример 16. Вызов оценки для SQL Server на экземпляре виртуальной машины Azure

Параметры

-Check

-Configuration

-FlattenOutput

-InputObject

-MinSeverity

-ProgressAction

Входные данные

Выходные данные

Связанные ссылки

Обратная связь

Обратная связь

Дополнительные ресурсы