Get-SqlSensitivityClassification

  • Riferimento
Modulo:
SQLServer

Ottenere l'etichetta di riservatezza e il tipo di informazioni delle colonne nel database.

Sintassi

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

Descrizione

Il cmdlet Get-SqlSensitivityClassification ottiene le etichette di riservatezza e i tipi di informazioni delle colonne nel database.

È anche possibile visualizzare le etichette di riservatezza e i tipi di informazioni delle colonne usando SQL Server Management Studio (SSMS) versione 17.5 e successive oppure la vista del catalogo delle proprietà estese .

È possibile impostare le etichette di riservatezza e i tipi di informazioni delle colonne usando SQL Server Management Studio (SSMS) versione 17.5 e successive oppure con il cmdlet set-SqlSensitivityClassification .

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

Esempio

Esempio 1: Ottenere tutti i tipi di informazioni e le etichette di riservatezza da un database usando l'autenticazione di 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

Questo comando ottiene il tipo di informazioni e l'etichetta di riservatezza di tutte le colonne nel database. Il cmdlet restituisce solo le colonne con un tipo di informazioni o un'etichetta di riservatezza (o entrambe) definite.

Esempio 2: Ottenere il tipo di informazioni e l'etichetta di riservatezza di una singola colonna dal database specificando il percorso

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

Questo comando ottiene il tipo di informazioni e l'etichetta di riservatezza della colonna Sales.Customers.email nel database fornito nel percorso.

Esempio 3: Ottenere etichette di riservatezza e tipi di informazioni di più colonne usando il contesto del percorso corrente

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

Questo comando ottiene il tipo di informazioni e l'etichetta di riservatezza di più colonne nel database usando e l'argomento matrice contenente i nomi delle colonne e il contesto del percorso corrente per individuare il database.

Le colonne senza tipo di informazioni o etichetta di riservatezza, ad esempio Sales.Customers.ip_Addess nell'esempio, restituiranno risultati vuoti.

Parametri

-ColumnName

Nomi delle colonne per cui viene recuperato il tipo di informazioni e l'etichetta di riservatezza.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
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

-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

-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

Output

System.Object