Share via


Invoke-SqlAssessment

Executa verificações de melhores práticas da Avaliação do SQL para um objeto SQL Server escolhido e retorna seus resultados.

Syntax

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

Description

O cmdlet Invoke-SqlAssessment executa uma avaliação para cada objeto de entrada e retorna uma lista de recomendações de práticas recomendadas que devem ser aplicadas aos objetos especificados. Cabe a você seguir as recomendações fornecidas ou não. Para obter mais informações, consulte a visão geral da API de Avaliação do SQL.

Esse cmdlet aceita os seguintes tipos de entrada:

  • 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
  • Cadeia de caracteres que contém o caminho para qualquer objeto dos tipos acima
  • Coleção de objetos

Você pode obter objetos de entrada com cmdlets SqlServer, como Get-SqlInstance e Get-SqlDatabase ou cmdlets básicos do PowerShell, como Get-Item e Get-ChildItem. Além disso, o cmdlet dá suporte ao SQL Server provedor do PowerShell, para que ele possa obter um objeto de seu caminho. O caminho pode ser passado explicitamente, caso contrário, o caminho atual será usado.

A disponibilidade de um marcar para um objeto escolhido varia na versão SQL Server, plataforma e tipo de objeto. Além disso, há verificações direcionadas a bancos de dados específicos, como tempdb ou master. Você também pode filtrar verificações por marcas, nomes e gravidade com os parâmetros -MinSeverity e -Check.

Você pode obter uma lista de verificações aplicáveis ao objeto SQL Server fornecido com o cmdlet Get-SqlAssessmentItem.

O cmdlet executa somente verificações aplicáveis a um objeto de entrada. Por exemplo, as verificações de banco de dados não serão executadas para uma instância de SQL Server ou um grupo de disponibilidade, mesmo quando especificado na lista -Check.

As configurações personalizadas podem ser aplicadas com o parâmetro -Configuration. Os exemplos de personalização estão disponíveis no Github.

Observação. Na primeira visualização pública , Invoke-SqlAssessment retornou objetos AssessmentNote com as propriedades CheckId e CheckName que contêm a ID de Check e DisplayName, respectivamente. Na segunda visualização pública, as duas propriedades foram substituídas por uma única propriedade Check, fornecendo muito mais dados. Supondo que $note foi um objeto retornado por Invoke-SqlAssessment, você pode acessar a ID do marcar como $note.Check.Id em vez de $note. CheckId ou a descrição do marcar como $note. Check.Description. Você pode usar o parâmetro -FlattenOutput para obter resultados no formato anterior com CheckId e CheckName. Esse parâmetro também ajudará a manter a compatibilidade com alguns cmdlets, como Write-SqlTableData. Confira os exemplos 12-14 para obter mais detalhes.

A saída do cmdlet Invoke-SqlAssessment é uma lista de práticas recomendadas violadas para cada objeto SQL Server fornecido. Use a propriedade Description para saber mais sobre a melhor prática e a propriedade Message para descobrir como ela pode ser resolvida. Além disso, cada resultado marcar contém um link para a documentação online, o que ajudará você a descobrir melhor o problema.

SQL Server no suporte à VM do Azure

Com os cmdlets de Avaliação de SQL, você pode avaliar uma instância de SQL Server na VM do Azure não apenas como SQL Server local, mas também com regras específicas para SQL Server na VM do Azure (que usam informações sobre a configuração da máquina virtual). Por exemplo, a regra AzSqlVmSize verifica se a VM que hospeda uma instância de SQL Server na VM do Azure é de tamanho recomendado.

Para usar essas regras, conecte-se ao Azure com Azure PowerShell Module e verifique se o módulo Az.ResourceGraph está instalado.

Entre com Azure PowerShell antes de invocar a Avaliação do SQL em relação a um SQL Server na instância de VM do Azure. O exemplo 16 mostra o processo de entrada interativo e a seleção de assinatura.

Observação. É possível usar a conexão de conta do Azure persistida entre as sessões do PowerShell, ou seja, invocar Connect-AzAccount em uma sessão e omitir esse comando posteriormente. No entanto, a versão atual dos cmdlets de Avaliação do SQL precisa que o módulo Az.ResourceGraph seja importado explicitamente neste caso: Import-Module Az.ResourceGraph

Exemplos

Exemplo 1: Invocar avaliação para a instância padrão local

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.
...

Este exemplo mostra como obter todas as recomendações de práticas recomendadas para a instância padrão de SQL Server em execução no computador atual.

Exemplo 2: Invocar avaliação com cmdlet 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.
...

Este exemplo mostra como obter todas as recomendações de práticas recomendadas para a instância padrão do SQL Server.

Exemplo 3: Invocar avaliação com o caminho do provedor 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.
...

Este exemplo mostra como obter todas as recomendações de práticas recomendadas para a instância padrão do SQL Server.

Exemplo 4: Invocar avaliação com configuração personalizada

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
...

Este exemplo mostra como aplicar a configuração personalizada para obter um conjunto modificado de recomendações de práticas recomendadas. As configurações personalizadas são descritas em arquivos JSON. O perfil de conjuntos de regras personalizadosA.json e profileB.json desabilitou algumas verificações e introduziu algumas novas. Uma das novas verificações de profileA.json detectou um problema com a configuração atual da instância SQL Server. Visite a pasta de exemplos de Avaliação do SQL no Github para descobrir como fazer a personalização.

Exemplo 5: Invocar avaliação para todas as instâncias

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.
...

Este exemplo mostra o cmdlet Invoke-SqlAssessment aceitando um conjunto de instâncias de SQL Server por meio de pipeline.

Exemplo 6: Executar avaliação para um conjunto filtrado 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.
...

Este exemplo mostra o cmdlet Invoke-SqlAssessment aceitando um conjunto de instâncias de SQL Server por meio de pipeline. O conjunto é filtrado com o cmdlet de Where-Object padrão do PowerShell.

Exemplo 7: Invocar avaliação para um banco de dados por nome

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

Este exemplo mostra o cmdlet Invoke-SqlAssessment aceitando o nome de um banco de dados. Nesse caso, nenhum problema foi encontrado.

Exemplo 8: Invocar avaliação para um banco de dados por caminho

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

Este exemplo mostra o cmdlet Invoke-SqlAssessment aceitando o caminho para um banco de dados SQL Server.

Exemplo 9: Detectar problemas altos para um banco de dados

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

Este exemplo mostra o cmdlet Invoke-SqlAssessment avaliando o local atual. Somente problemas altos são relatados.

Exemplo 10: Executar verificações selecionadas por marca

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

Este exemplo mostra o cmdlet Invoke-SqlAssessment executando todas as verificações relacionadas ao backup para cada instância de SQL Server no servidor local.

Exemplo 11: Executar verificações selecionadas interativamente

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.

A segunda linha deste exemplo mostra a obtenção de verificações de um $serverInstance e a seleção interativa de algumas delas. Os itens selecionados são armazenados em uma variável de matriz, que é usada como entrada para cmdlet Invoke-SqlAssessment . Somente as verificações escolhidas são executadas durante o processo de avaliação.

Exemplo 12: efeito do parâmetro -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....

Este exemplo mostra a diferença entre os objetos retornados com ou sem o parâmetro -FlattenOutput. O parâmetro substitui o enorme objeto Check complexo por duas propriedades de cadeia de caracteres CheckId e CheckName. Isso é útil para fins de serialização (consulte o próximo exemplo).

O primeiro comando mostra um objeto simples com todas as propriedades da cadeia de caracteres de tipo.

O segundo comando mostra outro objeto com duas propriedades que não são de cadeia de caracteres: Check e Severity.

O terceiro comando mostra o conjunto avançado de dados acessível com a propriedade Check.

Exemplo 13: executar verificações com falha novamente

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.

Este exemplo mostra como uma Verificação retornada com os resultados da avaliação pode ser reutilizado. Você pode executar novamente as verificações que produziram AssessmentNotes antes.

Exemplo 14: Armazenar resultados de avaliação em uma tabela

PS:> $serverInstance = Get-SqlInstance -ServerInstance '(local)'
PS:> Invoke-SqlAssessment $serverInstance -FlattenOutput | 
     Write-SqlTableData -ServerInstance localhost -DatabaseName SqlAssessment -SchemaName Assessment -TableName Results -Force

A segunda linha deste exemplo mostra o uso do parâmetro -FlattenOutput com Write-SqlTableData cmdlet para armazenar os resultados da avaliação em um banco de dados SQL.

Exemplo 15: Especificar credenciais explicitamente

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

Este exemplo mostra como invocar a Avaliação do SQL com credenciais especificadas explicitamente.

Exemplo 16: Invocar avaliação para um SQL Server na instância de VM do 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

Este exemplo mostra como invocar a avaliação de um SQL Server na instância de VM do Azure.

Uma conexão de assinatura ativa do Azure habilita SQL Server em verificações relacionadas à VM do Azure (AzSqlVmSize neste exemplo). A primeira linha se conecta a uma conta do Azure para obter dados do Azure Resource Graph. A segunda linha é opcional.

Para executar essas verificações, a Avaliação do SQL requer o módulo Az.ResourceGraph.

Parâmetros

-Check

Uma ou mais verificações, marcar IDs ou marcas.

Para cada objeto marcar, Invoke-SqlAssessment é executado que marcar se ele der suporte ao objeto de entrada.

Para cada ID de marcar, Invoke-SqlAssessment executará o marcar correspondente se ele der suporte ao objeto de entrada.

Para marcas, Invoke-SqlAssessment executa verificações com qualquer uma dessas marcas.

Type:Object[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Configuration

Especifica caminhos para arquivos que contêm configuração personalizada. Os arquivos de personalização serão aplicados à configuração padrão na ordem especificada. O escopo é limitado apenas a essa invocação de cmdlet.

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

-FlattenOutput

Indica que esse cmdlet produz objetos simples do tipo Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNoteFlat em vez de Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNote.

O AssessmentNote regular retornado de Invoke-SqlAssessment contém referências a outros objetos complexos úteis, como Check (veja o exemplo 12). Com a propriedade Check, você pode obter a descrição do marcar ou reutilizar o marcar (confira o exemplo 13). Mas alguns cmdlets não dão suporte a propriedades complexas. Por exemplo, Write-SqlTableData gerará um erro ao tentar gravar AssessmentNote em um banco de dados. Para evitar isso, você pode usar o parâmetro -FlattenOutput para substituir a propriedade Check por duas cadeias de caracteres simples: CheckId e CheckName (confira o exemplo 14).

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

-InputObject

Especifica um objeto SQL Server ou o caminho para esse objeto. O cmdlet executa a avaliação desse objeto. Quando esse parâmetro é omitido, o local atual é usado como objeto de entrada. Se o local atual não for um objeto SQL Server com suporte, o cmdlet sinalizará um erro.

Type:PSObject
Aliases:Target
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MinSeverity

Especifica o nível mínimo de severidade para que as verificações sejam encontradas. Por exemplo, verificações de níveis baixo, médio ou de informações não serão retornadas quando -MinSeverity High.

Type:SeverityLevel
Aliases:Severity
Accepted values:Information, Low, Medium, High
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

System.String[]

Microsoft.SqlServer.Management.Smo.SqlSmoObject[]

Saídas

Microsoft.SqlServer.Assessment.Cmdlets.AssessmentNote