Partager via

Get-SqlSensitivityClassification

  • Référence
Module:
SQLServer

Obtenez l’étiquette de confidentialité et le type d’informations des colonnes dans la base de données.

Syntaxe

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

Description

L’applet de commande Get-SqlSensitivityClassification obtient les étiquettes de confidentialité et les types d’informations des colonnes de la base de données.

Les étiquettes de confidentialité et les types d’informations des colonnes peuvent également être consultés à l’aide de SQL Server Management Studio (SSMS) version 17.5 et ultérieures, ou de l’affichage catalogue des propriétés étendues .

Les étiquettes de confidentialité et les types d’informations des colonnes peuvent être définis à l’aide de SQL Server Management Studio (SSMS) version 17.5 et ultérieures, ou avec l’applet de commande Set-SqlSensitivityClassification.

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

Exemples

Exemple 1 : Obtenir tous les types d’informations et étiquettes de confidentialité d’une base de données à l’aide de l’authentification 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

Cette commande obtient le type d’informations et l’étiquette de confidentialité de toutes les colonnes de la base de données. L’applet de commande retourne uniquement les colonnes qui ont un type d’information ou une étiquette de confidentialité (ou les deux) définies.

Exemple 2 : Obtenir le type d’informations et l’étiquette de confidentialité d’une seule colonne à partir d’une base de données en fournissant le chemin d’accès

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

Cette commande obtient le type d’informations et l’étiquette de confidentialité de la colonne Sales.Customers.email dans la base de données fournie dans le chemin d’accès.

Exemple 3 : Obtenir des étiquettes de confidentialité et des types d’informations de plusieurs colonnes à l’aide du contexte de chemin d’accès actuel

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

Cette commande obtient le type d’informations et l’étiquette de confidentialité de plusieurs colonnes dans la base de données à l’aide de l’argument de tableau contenant les noms de colonnes et le contexte de chemin d’accès actuel pour localiser la base de données.

Les colonnes qui n’ont aucun type d’information ou étiquette de confidentialité, telles que Sales.Customers.ip_Addess dans l’exemple, retournent des résultats vides.

Paramètres

-ColumnName

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

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
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

-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

-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

Sorties

System.Object