Partilhar 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

ByContext (Padrão)

Set-SqlSensitivityClassification
    -ColumnName <String[]>
    [-SuppressProviderContextWarning]
    [-SensitivityRank <SensitivityRank>]
    [-InformationType <String>]
    [-SensitivityLabel <String>]
    [<CommonParameters>]

ByConnectionString

Set-SqlSensitivityClassification
    -ColumnName <String[]>
    -ConnectionString <String>
    [-SensitivityRank <SensitivityRank>]
    [-InformationType <String>]
    [-SensitivityLabel <String>]
    [<CommonParameters>]

ByConnectionParameters

Set-SqlSensitivityClassification
    -ColumnName <String[]>
    -ServerInstance <PSObject>
    -DatabaseName <String>
    [-Credential <PSCredential>]
    [-SensitivityRank <SensitivityRank>]
    [-InformationType <String>]
    [-SensitivityLabel <String>]
    [<CommonParameters>]

ByPath

Set-SqlSensitivityClassification
    -ColumnName <String[]>
    -Path <String>
    [-SensitivityRank <SensitivityRank>]
    [-InformationType <String>]
    [-SensitivityLabel <String>]
    [<CommonParameters>]

ByDBObject

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 o SSMS (SQL Server Management Studio) versão 17.5 e superior.

O tipo de informação e o rótulo de confidencialidade e o tipo de informações de colunas podem ser exibidos usando o SSMS (SQL Server Management Studio) versão 17.5 e superior, a exibição de catálogo de 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 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 da coluna Sales.Customers.first_name 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 da coluna Sales.Customers.ip_address para Confidential usar 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 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.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Coluna

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByConnectionString
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Credential

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

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByConnectionParameters
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByConnectionParameters
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:Networking, Contact Info, Credentials, Credit Card, Banking, Financial, Other, Name, National ID, SSN, Health, Date Of Birth
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-InputObject

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

Propriedades do parâmetro

Tipo:Database
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByDBObject
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByPath
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:Public, General, Confidential, Confidential - GDPR, Highly Confidential, Highly Confidential - GDPR
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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

Propriedades do parâmetro

Tipo:SensitivityRank
Valor padrão:None
Valores aceitos:None, Low, Medium, High, Critical
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:PSObject
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByConnectionParameters
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByContext
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

System.String

Microsoft.SqlServer.Management.Smo.Database

System.String

Saídas

System.Object