Partilhar via


Invoke-SqlAssessment

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

Sintaxe

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

Description

O cmdlet Invoke-SqlAssessment executa uma avaliação para cada objeto de entrada e retorna uma lista de recomendações de prática recomendada 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 provedor do SQL Server 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 uma verificação de um objeto escolhido varia na versão, plataforma e tipo de objeto do SQL Server. Além disso, há verificações direcionadas a bancos de dados específicos, como tempdb ou master. Além disso, você 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 do SQL Server fornecido com 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 do SQL Server ou um grupo de disponibilidade, mesmo quando especificado em -Check lista.

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

NOTA. Na primeira visualização pública Invoke-SqlAssessment objetos AssessmentNote retornados 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 pelo Invoke-SqlAssessment, você pode acessar a ID da verificação como $note.Check.Id em vez de $note. CheckId ou a descrição da verificação como $note. Check.Description. Você pode usar -FlattenOutput parâmetro 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 do SQL Server fornecido. Use a propriedade Description para saber mais sobre as práticas recomendadas e propriedade message para descobrir como ela pode ser resolvida. Além disso, cada resultado de verificação contém um link para a documentação online, o que ajudará você a descobrir melhor o problema.

Suporte ao SQL Server na VM do Azure

Com os cmdlets de Avaliação do SQL, você pode avaliar uma instância do SQL Server na VM do Azure não apenas como SQL Server local, mas também com regras específicas do 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 do SQL Server na VM do Azure tem o tamanho recomendado.

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

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

NOTA. É 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 mais tarde. 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 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ática recomendada para a instância padrão do 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ática recomendada para a instância padrão do SQL Server.

Exemplo 3: invocar a avaliação com o caminho do provedor de 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ática recomendada 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. Conjuntos de regras personalizados profileA.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 do SQL Server. Visite 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 cmdlet Invoke-SqlAssessment aceitando um conjunto de instâncias do 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 cmdlet Invoke-SqlAssessment aceitando um conjunto de instâncias do 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 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 cmdlet Invoke-SqlAssessment aceitando o caminho para um banco de dados do 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 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 cmdlet Invoke-SqlAssessment executando todas as verificações relacionadas a backup para cada instância do 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 uma $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 -FlattenOutput parâmetro. O parâmetro substitui um enorme objeto check complexo por duas propriedades de cadeia de caracteres CheckId e CheckName. Isso é útil para fins de serialização (confira 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: Verificação e gravidade.

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 os resultados da 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 como usar -FlattenOutput parâmetro com Write-SqlTableData cmdlet para armazenar resultados de 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 para um SQL Server na instância de VM do Azure.

Uma conexão de assinatura ativa do Azure habilita o 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, verificar IDs ou marcas.

Para cada objeto de verificação, Invoke-SqlAssessment executa que verificam se ele dá suporte ao objeto de entrada.

Para cada ID de verificação, Invoke-SqlAssessment executa a verificação correspondente se ele dá suporte ao objeto de entrada.

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

Tipo:Object[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Configuration

Especifica caminhos para arquivos que contêm a 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.

Tipo:PSObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 da verificação ou reutilizar a verificação (veja o exemplo 13). Mas alguns cmdlets não dão suporte a propriedades complexas. Por exemplo, Write-SqlTableData gerará um erro ao tentar gravar o AssessmentNote em um banco de dados. Para evitar isso, você pode usar -FlattenOutput parâmetro para substituir a propriedade Check por duas cadeias de caracteres simples: CheckId e CheckName (consulte o exemplo 14).

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

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

Tipo:PSObject
Aliases:Target
Cargo:10
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MinSeverity

Especifica o nível mínimo de severidade para verificações a serem encontradas. Por exemplo, verificações de níveis baixos, médios ou de informações não serão retornadas quando -MinSeverity Alta.

Tipo:SeverityLevel
Aliases:Severity
Valores aceitos:Information, Low, Medium, High
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ProgressAction

Determina como o PowerShell responde às atualizações de progresso geradas por um script, cmdlet ou provedor, como as barras de progresso geradas pelo cmdlet Write-Progress. O cmdlet Write-Progress cria barras de progresso que mostram o status de um comando.

Tipo:ActionPreference
Aliases:proga
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

System.String[]

Microsoft.SqlServer.Management.Smo.SqlSmoObject[]

Saídas

Microsoft.SqlServer.Assessment.Cmdlets.AssessmentNote