Set-SqlSensitivityClassification

  • Riferimento
Modulo:
SQLServer

Impostare il tipo di informazioni e/o l'etichetta di riservatezza e il tipo di informazioni delle colonne nel database.

Sintassi

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

Descrizione

Il cmdlet Set-SqlSensitivityClassification imposta il tipo di informazioni e/o l'etichetta Riservatezza delle colonne nel database.

Il tipo di informazioni e l'etichetta di riservatezza e il tipo di informazioni delle colonne vengono impostati anche usando SQL Server Management Studio (SSMS) versione 17.5 e successive.

È possibile visualizzare il tipo di informazioni e l'etichetta di riservatezza e il tipo di informazioni delle colonne usando SQL Server Management Studio (SSMS) versione 17.5 e successive, la vista del catalogo delle proprietà estese o il cmdlet get-SqlSensitivityClassification .

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

Esempio

Esempio 1: Impostare il tipo di informazioni e l'etichetta di riservatezza in una singola colonna usando l'autenticazione di 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

Impostare rispettivamente il tipo di informazioni e l'etichetta di riservatezza della colonna Sales.Customers.first_name su Name e Confidential - GDPR. I valori per il tipo di informazioni e l'etichetta di riservatezza sono limitati ai valori predefiniti indicati di seguito e possono essere ottenuti usando il tasto TAB.

Esempio 2: Impostare il tipo di informazioni di una singola colonna usando l'autenticazione di 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

Impostare il tipo di informazioni della colonna Sales.Customers.first_name su Personal. L'etichetta di riservatezza verrà annullata se è stata impostata in precedenza.

Esempio 3: Impostare l'etichetta di riservatezza di una singola colonna usando i parametri di connessione

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

Impostare l'etichetta di riservatezza della colonna Sales.Customers.ip_address su Confidential usando l'account di accesso di SQL Server. Il tipo di informazioni per questa colonna rimane non impostato. Questo comando richiede la password per completare l'autenticazione.

Esempio 4: Impostare il tipo di informazioni e l'etichetta di classificazione di più colonne usando il contesto del percorso corrente

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

Impostare il tipo di informazioni e l'etichetta di riservatezza della colonna Sales.Customers.first_name e Sales.Customers.last_name fornendo una matrice di nomi di colonna come argomento al cmdlet . Tutte le colonne riceveranno lo stesso tipo di informazioni e la stessa etichetta di riservatezza. Le informazioni di connessione al database vengono ricavate dal contesto creato da Set-Location.

Parametri

-ColumnName

Nomi delle colonne per cui è impostata l'etichetta di riservatezza e il tipo di informazioni.

Tipo:String[]
Alias:Column
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ConnectionString

Specifica una stringa di connessione per la connessione al database. Se questo parametro è presente, gli altri parametri di connessione verranno ignorati

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Specifica una credenziale utilizzata per connettersi al database.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DatabaseName

Specifica il nome di un database. Questo cmdlet si connette a questo database nell'istanza specificata nel parametro ServerInstance.

Se il parametro DatabaseName non viene specificato, il database utilizzato dipende dal fatto che il percorso corrente specifichi sia la cartella SQLSERVER:\SQL che il nome del database. Se il percorso specifica sia la cartella SQL che il nome di un database, questo cmdlet si connette al database specificato nel percorso.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InformationType

Nome che descrive il tipo di informazioni archiviato nelle colonne. È necessario specificare un valore per SensitivityLabel, InformationType o entrambi. I valori possibili sono limitati e non possono essere estesi.

Tipo:String
Valori accettati:Networking, Contact Info, Credentials, Credit Card, Banking, Financial, Other, Name, National ID, SSN, Health, Date Of Birth
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-InputObject

Specifica un SMO (SQL Server Management Object) che rappresenta il database utilizzato da questo cmdlet.

Tipo:Database
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Path

Specifica il percorso dell'istanza di SQL Server in cui questo cmdlet esegue l'operazione. Se non si specifica un valore per questo parametro, il cmdlet usa la posizione di lavoro corrente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProgressAction

Determina in che modo PowerShell risponde agli aggiornamenti dello stato generati da uno script, un cmdlet o un provider, ad esempio le barre di stato generate dal cmdlet Write-Progress. Il cmdlet Write-Progress crea barre di stato che mostrano lo stato di un comando.

Tipo:ActionPreference
Alias:proga
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SensitivityLabel

Nome che descrive la riservatezza dei dati archiviati nelle colonne. È necessario specificare un valore per SensitivityLabel, InformationType o entrambi. I valori possibili sono limitati e non possono essere estesi.

Tipo:String
Valori accettati:Public, General, Confidential, Confidential - GDPR, Highly Confidential, Highly Confidential - GDPR
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SensitivityRank

Identificatore basato su un set predefinito di valori che definiscono la classificazione di riservatezza. Può essere usato da altri servizi come Advanced Threat Protection per rilevare anomalie in base alla classificazione

Tipo:SensitivityRank
Valori accettati:None, Low, Medium, High, Critical
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServerInstance

Specifica il nome dell'istanza del server (una stringa) o dell'oggetto SMO (SQL Server Management Objects) che specifica il nome di un'istanza del motore di database. Per le istanze predefinite, specificare solo il nome del computer MyComputer. Per le istanze denominate, usare il formato NomeComputer\NomeIstanza.

Tipo:PSObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SuppressProviderContextWarning

Indica che questo cmdlet elimina l'avviso che questo cmdlet è stato usato nel contesto del database dall'impostazione del percorso SQLSERVER:\SQL corrente per stabilire il contesto del database per il cmdlet.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

System.String[]

Microsoft.SqlServer.Management.Smo.Database

System.String

Output

System.Object