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.

Syntax

Get-SqlSensitivityClassification
   [-ColumnName <String[]>]
   [-SuppressProviderContextWarning]
   [<CommonParameters>]
Get-SqlSensitivityClassification
   [-ColumnName <String[]>]
   -ConnectionString <String>
   [<CommonParameters>]
Get-SqlSensitivityClassification
   [-ColumnName <String[]>]
   -ServerInstance <PSObject>
   -DatabaseName <String>
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SqlSensitivityClassification
   [-ColumnName <String[]>]
   -Path <String>
   [<CommonParameters>]
Get-SqlSensitivityClassification
   [-ColumnName <String[]>]
   -InputObject <Database>
   [<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 de 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 Propriétés étendues.

Les étiquettes de confidentialité et les types d’informations de 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 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 de la 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 Sales.Customers.email colonne 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 et 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é, comme 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 extraits.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 d’accès 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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ServerInstance

Spécifie le nom de l’instance de serveur (une chaîne) ou SQL Server objet SMO (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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

System.String[]

Microsoft.SqlServer.Management.Smo.Database

Sorties

System.Object