Freigeben über


Set-SqlSensitivityClassification

Legen Sie den Informationstyp und/oder die Vertraulichkeitsbezeichnung und den Informationstyp der Spalten in der Datenbank fest.

Syntax

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

Beschreibung

Das Cmdlet Set-SqlSensitivityClassification legt den Informationstyp und/oder die Vertraulichkeitsbezeichnung von Spalten in der Datenbank fest.

Der Informationstyp und die Vertraulichkeitsbezeichnung und der Informationstyp von Spalten werden auch mithilfe SQL Server Management Studio (SSMS) Version 17.5 und höher festgelegt.

Der Informationstyp und der Vertraulichkeitsbezeichnung und der Informationstyp von Spalten können mit SQL Server Management Studio (SSMS) Version 17.5 und höher, der Erweiterten Eigenschaftenkatalogansichtoder dem cmdlet Get-SqlSensitivityClassification angezeigt werden.

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

Beispiele

Beispiel 1: Festlegen des Informationstyps und der Vertraulichkeitsbezeichnung für eine einzelne Spalte mithilfe der Windows-Authentifizierung

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

Legen Sie den Informationstyp und die Vertraulichkeitsbezeichnung der Spalte Sales.Customers.first_name auf Name bzw. Confidential - GDPR fest. Die Werte für Informationstyp und Vertraulichkeitsbezeichnung sind auf die unten angegebenen Standardwerte beschränkt und können mithilfe der TAB-TASTE abgerufen werden.

Beispiel 2: Festlegen des Informationstyps einer einzelnen Spalte mithilfe der Windows-Authentifizierung

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

Legen Sie den Informationstyp der Spalte Sales.Customers.first_name auf Personalfest. Die Vertraulichkeitsbezeichnung wird nicht festgelegt, wenn sie zuvor festgelegt wurde.

Beispiel 3: Festlegen der Vertraulichkeitsbezeichnung einer einzelnen Spalte mithilfe von Verbindungsparametern

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

Legen Sie die Vertraulichkeitsbezeichnung der Spalte Sales.Customers.ip_address mithilfe der SQL Server-Anmeldung auf Confidential fest. Der Informationstyp für diese Spalte bleibt nicht festgelegt. Mit diesem Befehl werden Sie aufgefordert, ein Kennwort zum Abschließen der Authentifizierung einzugeben.

Beispiel 4: Festlegen des Informationstyps und der Klassifizierungsbezeichnung mehrerer Spalten mithilfe des aktuellen Pfadkontexts

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

Legen Sie den Informationstyp und die Vertraulichkeitsbezeichnung von Spalten Sales.Customers.first_name und Sales.Customers.last_name fest, indem Sie ein Array von Spaltennamen als Argument für das Cmdlet bereitstellen. Alle Spalten erhalten denselben Informationstyp und dieselbe Vertraulichkeitsbezeichnung. Datenbankverbindungsinformationen werden aus dem Kontext entnommen, der von Set-Locationerstellt wird.

Parameter

-ColumnName

Name(en) von Spalten, für die der Informationstyp und die Vertraulichkeitsbezeichnung festgelegt sind.

Typ:String[]
Aliase:Column
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ConnectionString

Gibt eine Verbindungszeichenfolge an, die mit der Datenbank verbunden werden soll. Wenn dieser Parameter vorhanden ist, werden andere Verbindungsparameter ignoriert.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt eine Anmeldeinformation an, die zum Herstellen einer Verbindung mit der Datenbank verwendet wird.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DatabaseName

Gibt den Namen einer Datenbank an. Mit diesem Cmdlet wird eine Verbindung mit dieser Datenbank in der Instanz hergestellt, die im Parameter "ServerInstance" angegeben ist.

Wenn der parameter DatabaseName nicht angegeben ist, hängt die verwendete Datenbank davon ab, ob der aktuelle Pfad sowohl den SQLSERVER:\SQL-Ordner als auch einen Datenbanknamen angibt. Wenn der Pfad sowohl den SQL-Ordner als auch einen Datenbanknamen angibt, stellt dieses Cmdlet eine Verbindung mit der Datenbank herstellt, die im Pfad angegeben ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationType

Ein Name, der den Informationstyp beschreibt, der in den Spalten(n) gespeichert ist. Sie müssen einen Wert für SensitivityLabel, InformationType oder beides angeben. Mögliche Werte sind begrenzt und können nicht erweitert werden.

Typ:String
Zulässige Werte:Networking, Contact Info, Credentials, Credit Card, Banking, Financial, Other, Name, National ID, SSN, Health, Date Of Birth
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein SQL Server Management Object (SMO) an, das die von diesem Cmdlet verwendete Datenbank darstellt.

Typ:Database
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Pfad zur Instanz von SQL Server an, auf der dieses Cmdlet den Vorgang ausführt. Wenn Sie keinen Wert für diesen Parameter angeben, verwendet das Cmdlet den aktuellen Arbeitsspeicherort.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProgressAction

Bestimmt, wie PowerShell auf Statusaktualisierungen reagiert, die von einem Skript, Cmdlet oder Anbieter generiert werden, z. B. auf die Statusanzeigen, die vom Cmdlet Write-Progress generiert werden. Das Cmdlet Write-Progress erstellt Statusanzeigen, die den Status eines Befehls anzeigen.

Typ:ActionPreference
Aliase:proga
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SensitivityLabel

Ein Name, der die Vertraulichkeit der Daten beschreibt, die in den Spalten(en) gespeichert sind. Sie müssen einen Wert für SensitivityLabel, InformationType oder beides angeben. Mögliche Werte sind begrenzt und können nicht erweitert werden.

Typ:String
Zulässige Werte:Public, General, Confidential, Confidential - GDPR, Highly Confidential, Highly Confidential - GDPR
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SensitivityRank

Ein Bezeichner basierend auf einem vordefinierten Wertesatz, der die Vertraulichkeitsbewertung definiert. Kann von anderen Diensten wie Advanced Threat Protection verwendet werden, um Anomalien basierend auf ihrer Rangfolge zu erkennen.

Typ:SensitivityRank
Zulässige Werte:None, Low, Medium, High, Critical
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServerInstance

Gibt entweder den Namen der Serverinstanz (eine Zeichenfolge) oder des SMO-Objekts (SQL Server Management Objects) an, das den Namen einer Instanz des Datenbankmoduls angibt. Geben Sie für Standardinstanzen nur den Computernamen "MyComputer" an. Verwenden Sie für benannte Instanzen das Format "ComputerName\InstanceName".

Typ:PSObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SuppressProviderContextWarning

Gibt an, dass dieses Cmdlet die Warnung unterdrückt, dass dieses Cmdlet im Datenbankkontext aus der aktuellen SQLSERVER:\SQL-Pfadeinstellung verwendet wurde, um den Datenbankkontext für das Cmdlet einzurichten.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

System.String[]

Microsoft.SqlServer.Management.Smo.Database

System.String

Ausgaben

System.Object