Set-SqlSensitivityClassification

  • Referência
Módulo:
SQLServer

Defina o tipo de informação e/ou o tipo de informações e o rótulo de confidencialidade das colunas no banco de dados.

Syntax

Set-SqlSensitivityClassification
   -ColumnName <String[]>
   [-SuppressProviderContextWarning]
   [-SensitivityRank <SensitivityRank>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -ConnectionString <String>
   [-SensitivityRank <SensitivityRank>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -ServerInstance <PSObject>
   -DatabaseName <String>
   [-Credential <PSCredential>]
   [-SensitivityRank <SensitivityRank>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -Path <String>
   [-SensitivityRank <SensitivityRank>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -InputObject <Database>
   [-SensitivityRank <SensitivityRank>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]

Description

O cmdlet Set-SqlSensitivityClassification define o tipo de informação e/ou o rótulo de confidencialidade das colunas no banco de dados.

O tipo de informação e o rótulo de confidencialidade e o tipo de informações de colunas também serão definidos usando SQL Server Management Studio (SSMS) versão 17.5 e superior.

O tipo de informação e o rótulo de confidencialidade e o tipo de informações das colunas podem ser exibidos usando SQL Server Management Studio (SSMS) versão 17.5 e superior, a exibição de catálogo propriedades estendidas ou o cmdlet Get-SqlSensitivityClassification.

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

Exemplos

Exemplo 1: definir o tipo de informação e o rótulo de confidencialidade em uma única coluna usando autenticação do Windows

PS C:\> Set-SqlSensitivityClassification -ServerInstance "MyComputer\MainInstance" -Database "myDatabase" -ColumnName "Sales.Customers.first_name" -InformationType "Name" -SensitivityLabel "Confidential - GDPR" -SensitivityRank "Low"

Column                      InformationType SensitivityLabel    SensitivityRank
------                      --------------- ----------------    ---------------
Sales.Customers.first_name  Name            Confidential - GDPR Low

Defina o tipo de informação e o rótulo de confidencialidade da coluna Sales.Customers.first_name como Name e Confidential - GDPR respectivamente. Os valores de tipo de informação e rótulo de confidencialidade são limitados aos valores padrão fornecidos abaixo e podem ser obtidos usando a chave Tab.

Exemplo 2: definir o tipo de informação de uma única coluna usando autenticação do Windows

PS C:\> Set-SqlSensitivityClassification -ServerInstance "MyComputer\MainInstance" -Database "myDatabase" -ColumnName "Sales.Customers.first_name" -InformationType "Personal"

Column                      InformationType SensitivityLabel SensitivityRank
------                      --------------- ---------------- ---------------
Sales.Customers.first_name  Personal

Defina o tipo de informação da coluna Sales.Customers.first_name como Personal. O rótulo de confidencialidade será desconjunto se tiver sido definido anteriormente.

Exemplo 3: definir o rótulo de confidencialidade de uma única coluna usando parâmetros de conexão

PS C:\> Set-SqlSensitivityClassification -ServerInstance "MyComputer\MainInstance" -Database "myDatabase" -Credential (Get-Credential "sa") -ColumnName "Sales.Customers.ip_address" -SensitivityLabel "Confidential"

Column                      InformationType SensitivityLabel SensitivityRank
------                      --------------- ---------------- ---------------
Sales.Customers.ip_address                  Confidential

Defina o rótulo de confidencialidade da coluna Sales.Customers.ip_address para Confidential usar o logon SQL Server. O tipo de informação para esta coluna permanece não definido. Esse comando solicita uma senha para concluir a autenticação.

Exemplo 4: definir o tipo de informação e o rótulo de classificação de várias colunas usando o contexto de caminho atual

PS C:\> $columns = @("Sales.Customers.first_name" , "Sales.Customers.last_name")
PS C:\> Set-Location "SQLSERVER:\SQL\MyComputer\MainInstance\Databases\MyDatabase"
PS SQLSERVER:\SQL\MyComputer\MainInstance> Set-SqlSensitivityClassification -ColumnName $columns -InformationType "Name" -SensitivityLabel "Confidential - GDPR" -SensitivityRank "Critical"
 WARNING: Using provider context. Server = MyComputer, Database = MyDatabase.

Column                      InformationType SensitivityLabel    SensitivityRank
------                      --------------- ----------------    ---------------
Sales.Customers.first_name  Name            Confidential - GDPR Critical
Sales.Customers.last_name   Name            Confidential - GDPR Critical

Defina o tipo de informação e o rótulo de confidencialidade da coluna Sales.Customers.first_name e Sales.Customers.last_name fornecendo a matriz de nomes de coluna como argumento para o cmdlet. Todas as colunas receberão o mesmo tipo de informação e rótulo de confidencialidade. As informações de conexão de banco de dados são obtidas do contexto criado por Set-Location.

Parâmetros

-ColumnName

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

Type:String[]
Aliases:Column
Position:Named
Default value:None
Required:True
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

-InformationType

Um nome que descreve o tipo de informação armazenado nas colunas. Você deve fornecer um valor para SensitivityLabel, InformationType ou ambos. Os valores possíveis são limitados e não podem ser estendidos.

Type:String
Accepted values:Networking, Contact Info, Credentials, Credit Card, Banking, Financial, Other, Name, National ID, SSN, Health, Date Of Birth
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

-SensitivityLabel

Um nome que descreve a confidencialidade dos dados armazenados nas colunas. Você deve fornecer um valor para SensitivityLabel, InformationType ou ambos. Os valores possíveis são limitados e não podem ser estendidos.

Type:String
Accepted values:Public, General, Confidential, Confidential - GDPR, Highly Confidential, Highly Confidential - GDPR
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SensitivityRank

Um identificador baseado em um conjunto predefinido de valores que definem a classificação de confidencialidade. Pode ser usado por outros serviços, como a Proteção Avançada contra Ameaças, para detectar anomalias com base em sua classificação

Type:SensitivityRank
Accepted values:None, Low, Medium, High, Critical
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

System.String

Saídas

System.Object