Compartilhar via


Set-SqlSensitivityClassification

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.

Sintaxe

Set-SqlSensitivityClassification
   -ColumnName <String[]>
   [-SuppressProviderContextWarning]
   [-SensitivityRank <SensitivityRank>]
   [-ProgressAction <ActionPreference>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -ConnectionString <String>
   [-SensitivityRank <SensitivityRank>]
   [-ProgressAction <ActionPreference>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -ServerInstance <PSObject>
   -DatabaseName <String>
   [-Credential <PSCredential>]
   [-SensitivityRank <SensitivityRank>]
   [-ProgressAction <ActionPreference>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -Path <String>
   [-SensitivityRank <SensitivityRank>]
   [-ProgressAction <ActionPreference>]
   [-InformationType <String>]
   [-SensitivityLabel <String>]
   [<CommonParameters>]
Set-SqlSensitivityClassification
   -ColumnName <String[]>
   -InputObject <Database>
   [-SensitivityRank <SensitivityRank>]
   [-ProgressAction <ActionPreference>]
   [-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 SSMS (SQL Server Management Studio) versão 17.5 e superior, a exibição do catálogo Propriedades Estendidasou 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 a 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 do tipo de informação e do rótulo de confidencialidade são limitados aos valores padrão fornecidos abaixo e podem ser obtidos usando a tecla Tab.

Exemplo 2: Definir o tipo de informação de uma única coluna usando a 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 de Sales.Customers.first_name de coluna como Personal. O rótulo de confidencialidade não será definido se ele foi 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 do Sales.Customers.ip_address de coluna para Confidential usando o logon do SQL Server. O tipo de informação desta 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 pelo 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.

Tipo:String[]
Aliases:Column
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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

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

-Credential

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

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String
Valores aceitos:Networking, Contact Info, Credentials, Credit Card, Banking, Financial, Other, Name, National ID, SSN, Health, Date Of Birth
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-InputObject

Especifica um SMO (Objeto de Gerenciamento do SQL Server) que representa o banco de dados que esse cmdlet usa.

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

-Path

Especifica o caminho para a instância do 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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
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

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

Tipo:String
Valores aceitos:Public, General, Confidential, Confidential - GDPR, Highly Confidential, Highly Confidential - GDPR
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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

Tipo:SensitivityRank
Valores aceitos:None, Low, Medium, High, Critical
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServerInstance

Especifica o nome da instância do servidor (uma cadeia de caracteres) ou o objeto SMO (SQL Server Management Objects) 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.

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

-SuppressProviderContextWarning

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

Tipo:SwitchParameter
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.Database

System.String

Saídas

System.Object