Get-SqlSensitivityClassification

  • Referência
Módulo:
SQLServer

Obtenha o rótulo de confidencialidade e o tipo de informações de colunas no banco de dados.

Syntax

Get-SqlSensitivityClassification
   [-ColumnName <String[]>]
   [-SuppressProviderContextWarning]
   [<CommonParameters>]
Get-SqlSensitivityClassification
   [-ColumnName <String[]>]
   -ConnectionString <String>
   [<CommonParameters>]
Get-SqlSensitivityClassification
   [-ColumnName <String[]>]
   -ServerInstance <PSObject>
   -DatabaseName <String>
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SqlSensitivityClassification
   [-ColumnName <String[]>]
   -Path <String>
   [<CommonParameters>]
Get-SqlSensitivityClassification
   [-ColumnName <String[]>]
   -InputObject <Database>
   [<CommonParameters>]

Description

O cmdlet Get-SqlSensitivityClassification obtém os rótulos de confidencialidade e os tipos de informações de colunas no banco de dados.

Os rótulos de confidencialidade e os tipos de informações de colunas também podem ser exibidos usando SQL Server Management Studio (SSMS) versão 17.5 e superior, ou a exibição de catálogo propriedades estendidas.

Os rótulos de confidencialidade e os tipos de informações de colunas podem ser definidos usando SQL Server Management Studio (SSMS) versão 17.5 e superior, ou com o cmdlet Set-SqlSensitivityClassification.

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

Exemplos

Exemplo 1: obter todos os tipos de informações e rótulos de confidencialidade de um banco de dados usando autenticação do Windows

PS C:\> Get-SqlSensitivityClassification -ServerInstance "MyComputer\MainInstance" -Database "myDatabase"

Column                      InformationType SensitivityLabel    SensitivityRank
------                      --------------- ----------------    ---------------
Sales.Customers.email       Contact Info    Confidential        Medium
Sales.Customers.first_name  Name            Confidential - GDPR Medium

Esse comando obtém o tipo de informação e o rótulo de confidencialidade de todas as colunas no banco de dados. O cmdlet retorna apenas as colunas que têm um tipo de informação ou um rótulo de confidencialidade (ou ambos) definidos.

Exemplo 2: obter o tipo de informação e o rótulo de confidencialidade de uma única coluna do banco de dados fornecendo caminho

PS C:\> Get-SqlSensitivityClassification -Path "SQLSERVER:\SQL\MyComputer\MainInstance\Databases\MyDatabase" -ColumnName "Sales.Customers.email"

Column                    InformationType SensitivityLabel SensitivityRank
------                    --------------- ---------------- ---------------
Sales.Customers.email     Contact Info    Confidential     Medium

Esse comando obtém o tipo de informação e o rótulo de confidencialidade da Sales.Customers.email coluna no banco de dados fornecido no Caminho.

Exemplo 3: obter rótulos de confidencialidade e tipos de informações de várias colunas usando o contexto de caminho atual

PS C:\> $columns = @("Sales.Customers.ip_address" , "Sales.Customers.email")
PS C:\> Set-Location "SQLSERVER:\SQL\MyComputer\MainInstance\Databases\MyDatabase"
PS SQLSERVER:\SQL\MyComputer\MainInstance> Get-SqlSensitivityClassification -ColumnName $columns
 WARNING: Using provider context. Server = MyComputer, Database = MyDatabase. 

Column                      InformationType SensitivityLabel SensitivityRank
------                      --------------- ---------------- ---------------
Sales.Customers.email       Contact Info    Confidential     Medium
Sales.Customers.ip_address

Esse comando obtém o tipo de informação e o rótulo de confidencialidade de várias colunas no banco de dados usando e o argumento de matriz contendo os nomes de coluna e o contexto de caminho atual para localizar o banco de dados.

Colunas que não têm nenhum tipo de informação ou rótulo de confidencialidade, como Sales.Customers.ip_Addess no exemplo, retornarão resultados vazios.

Parâmetros

-ColumnName

Nome(s) de colunas para as quais o tipo de informação e o rótulo de confidencialidade são buscados.

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

-ConnectionString

Especifica uma cadeia de conexão para se conectar ao banco de dados. Se esse parâmetro estiver presente, outros parâmetros de conexão serão ignorados.

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

-Credential

Especifica uma credencial usada para se conectar ao banco de dados.

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

-DatabaseName

Especifica o nome de um banco de dados. Esse cmdlet se conecta a esse banco de dados na instância especificada no parâmetro ServerInstance.

Se o parâmetro DatabaseName não for especificado, o banco de dados usado dependerá se o caminho atual especifica a pasta SQLSERVER:\SQL e um nome de banco de dados. Se o caminho especificar a pasta SQL e um nome de banco de dados, esse cmdlet se conectará ao banco de dados especificado no caminho.

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

-InputObject

Especifica um SMO (objeto de gerenciamento de SQL Server) que representa o banco de dados que esse cmdlet usa.

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

-Path

Especifica o caminho para a instância de SQL Server na qual esse cmdlet executa a operação. Se você não especificar um valor para esse parâmetro, o cmdlet usará o local de trabalho atual.

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

-ServerInstance

Especifica o nome da instância do servidor (uma cadeia de caracteres) ou SQL Server objeto SMO (Objetos de Gerenciamento) que especifica o nome de uma instância do Mecanismo de Banco de Dados. Para instâncias padrão, especifique apenas o nome do computador: MyComputer. Para instâncias nomeadas, use o formato ComputerName\InstanceName.

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

-SuppressProviderContextWarning

Indica que esse cmdlet suprime o aviso de que esse cmdlet foi usado no contexto do banco de dados da configuração de caminho SQLSERVER:\SQL atual para estabelecer o contexto do banco de dados para o cmdlet.

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

Entradas

System.String[]

Microsoft.SqlServer.Management.Smo.Database

Saídas

System.Object