Partager via


Set-SqlSensitivityClassification

Définissez le type d’informations et/ou l’étiquette de confidentialité et le type d’informations des colonnes dans la base de données.

Syntaxe

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

L’applet de commande Set-SqlSensitivityClassification définit le type d’informations et/ou l’étiquette de confidentialité des colonnes dans la base de données.

Le type d’informations et l’étiquette de confidentialité et le type d’informations des colonnes doivent également être définis à l’aide de SQL Server Management Studio (SSMS) version 17.5 et ultérieures.

Le type d’informations et l’étiquette de confidentialité et le type d’informations des colonnes peuvent être consultés à l’aide de SQL Server Management Studio (SSMS) version 17.5 et ultérieures, de l’affichage catalogue des propriétés étendues , ou de l’applet de commande Get-SqlSensitivityClassification.

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

Exemples

Exemple 1 : Définir le type d’informations et l’étiquette de confidentialité sur une seule colonne à l’aide de l’authentification 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

Définissez respectivement le type d’informations et l’étiquette de confidentialité des Sales.Customers.first_name de colonne sur Name et Confidential - GDPR. Les valeurs pour le type d’informations et l’étiquette de confidentialité sont limitées aux valeurs par défaut fournies ci-dessous et peuvent être obtenues à l’aide de la touche Tab.

Exemple 2 : Définir le type d’informations d’une seule colonne à l’aide de l’authentification 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

Définissez le type d’informations de la colonne Sales.Customers.first_name sur Personal. L’étiquette de confidentialité n’est pas définie si elle a été définie précédemment.

Exemple 3 : Définir l’étiquette de confidentialité d’une seule colonne à l’aide de paramètres de connexion

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

Définissez l’étiquette de confidentialité de la colonne Sales.Customers.ip_address sur Confidential à l’aide de la connexion SQL Server. Le type d’informations de cette colonne reste non défini. Cette commande vous invite à entrer un mot de passe pour terminer l’authentification.

Exemple 4 : Définir le type d’informations et l’étiquette de classification de plusieurs colonnes à l’aide du contexte de chemin d’accès actuel

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

Définissez le type d’informations et l’étiquette de confidentialité de la colonne Sales.Customers.first_name et Sales.Customers.last_name en fournissant un tableau de noms de colonnes comme argument à l’applet de commande. Toutes les colonnes recevront le même type d’informations et l’étiquette de confidentialité. Les informations de connexion de base de données sont extraites du contexte créé par Set-Location.

Paramètres

-ColumnName

Nom(s) des colonnes pour lesquelles le type d’informations et l’étiquette de confidentialité sont définis.

Type:String[]
Alias:Column
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ConnectionString

Spécifie une chaîne de connexion à connecter à la base de données. Si ce paramètre est présent, d’autres paramètres de connexion sont ignorés

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie les informations d’identification utilisées pour se connecter à la base de données.

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DatabaseName

Spécifie le nom d’une base de données. Cette applet de commande se connecte à cette base de données dans l’instance spécifiée dans le paramètre ServerInstance.

Si le paramètre DatabaseName n’est pas spécifié, la base de données utilisée varie selon que le chemin actuel spécifie à la fois le dossier SQLSERVER :\SQL et un nom de base de données. Si le chemin d’accès spécifie à la fois le dossier SQL et un nom de base de données, cette applet de commande se connecte à la base de données spécifiée dans le chemin d’accès.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationType

Nom qui décrit le type d’informations stocké dans la ou les colonnes. Vous devez fournir une valeur pour SensitivityLabel, InformationType ou les deux. Les valeurs possibles sont limitées et ne peuvent pas être étendues.

Type:String
Valeurs acceptées:Networking, Contact Info, Credentials, Credit Card, Banking, Financial, Other, Name, National ID, SSN, Health, Date Of Birth
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-InputObject

Spécifie un objet SMO (SQL Server Management Object) qui représente la base de données utilisée par cette applet de commande.

Type:Database
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Path

Spécifie le chemin d’accès à l’instance de SQL Server sur laquelle cette applet de commande exécute l’opération. Si vous ne spécifiez pas de valeur pour ce paramètre, l’applet de commande utilise l’emplacement de travail actuel.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ProgressAction

Détermine comment PowerShell répond aux mises à jour de progression générées par un script, une applet de commande ou un fournisseur, telles que les barres de progression générées par l’applet de commande Write-Progress. L’applet de commande Write-Progress crée des barres de progression qui affichent l’état d’une commande.

Type:ActionPreference
Alias:proga
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SensitivityLabel

Nom qui décrit la sensibilité des données stockées dans la ou les colonnes. Vous devez fournir une valeur pour SensitivityLabel, InformationType ou les deux. Les valeurs possibles sont limitées et ne peuvent pas être étendues.

Type:String
Valeurs acceptées:Public, General, Confidential, Confidential - GDPR, Highly Confidential, Highly Confidential - GDPR
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SensitivityRank

Identificateur basé sur un ensemble prédéfini de valeurs qui définissent le classement de confidentialité. Peut être utilisé par d’autres services comme Advanced Threat Protection pour détecter les anomalies en fonction de leur classement

Type:SensitivityRank
Valeurs acceptées:None, Low, Medium, High, Critical
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ServerInstance

Spécifie le nom de l’instance de serveur (une chaîne) ou l’objet SMO (SQL Server Management Objects) qui spécifie le nom d’une instance du moteur de base de données. Pour les instances par défaut, spécifiez uniquement le nom de l’ordinateur : MyComputer. Pour les instances nommées, utilisez le format ComputerName\InstanceName.

Type:PSObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SuppressProviderContextWarning

Indique que cette applet de commande supprime l’avertissement que cette applet de commande a utilisé dans le contexte de base de données à partir du paramètre de chemin SQLSERVER :\SQL actuel pour établir le contexte de base de données de l’applet de commande.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

System.String[]

Microsoft.SqlServer.Management.Smo.Database

System.String

Sorties

System.Object