Поделиться через


Get-SqlSensitivityClassification

Получение метки конфиденциальности и типа сведений столбцов в базе данных.

Синтаксис

ByContext (по умолчанию)

Get-SqlSensitivityClassification
    [-ColumnName <String[]>]
    [-SuppressProviderContextWarning]
    [<CommonParameters>]

ByConnectionString

Get-SqlSensitivityClassification
    -ConnectionString <String>
    [-ColumnName <String[]>]
    [<CommonParameters>]

ByConnectionParameters

Get-SqlSensitivityClassification
    -ServerInstance <PSObject>
    -DatabaseName <String>
    [-ColumnName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

ByPath

Get-SqlSensitivityClassification
    -Path <String>
    [-ColumnName <String[]>]
    [<CommonParameters>]

ByDBObject

Get-SqlSensitivityClassification
    -InputObject <Database>
    [-ColumnName <String[]>]
    [<CommonParameters>]

Описание

Командлет Get-SqlSensitivityClassification получает метки конфиденциальности и типы сведений столбцов в базе данных.

Метки конфиденциальности и типы данных столбцов также можно просматривать с помощью SQL Server Management Studio (SSMS) версии 17.5 и более поздней версии или представления каталога расширенных свойств.

Метки конфиденциальности и типы данных столбцов можно задать с помощью SQL Server Management Studio (SSMS) выпуска 17.5 и более поздней версии или с командлетом Set-SqlSensitivityClassification .

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

Примеры

Пример 1. Получение всех типов сведений и меток конфиденциальности из базы данных с помощью проверки подлинности 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

Эта команда получает тип информации и метку конфиденциальности всех столбцов в базе данных. Командлет возвращает только столбцы, имеющие тип информации или метку конфиденциальности (или оба).

Пример 2. Получение метки сведений и метки конфиденциальности одного столбца из базы данных путем предоставления пути

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

Эта команда получает тип сведений и метку конфиденциальности столбца Sales.Customers.email в базе данных, предоставленной в path.

Пример 3. Получение меток конфиденциальности и типов сведений нескольких столбцов с помощью текущего контекста пути

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

Эта команда получает метку сведений и метку конфиденциальности нескольких столбцов в базе данных с использованием и аргументом массива, содержащим имена столбцов и текущий контекст пути для поиска базы данных.

Столбцы, не имеющие метки сведений или конфиденциальности, например Sales.Customers.ip_Addess в примере, возвращают пустые результаты.

Параметры

-ColumnName

Имена столбцов, для которых извлекается метка сведений и конфиденциальности.

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ConnectionString

Указывает строку подключения для подключения к базе данных. Если этот параметр присутствует, другие параметры подключения будут игнорироваться.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ByConnectionString
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Credential

Указывает учетные данные, используемые для подключения к базе данных.

Свойства параметра

Тип:PSCredential
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ByConnectionParameters
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DatabaseName

Указывает имя базы данных. Этот командлет подключается к этой базе данных в экземпляре, указанном в параметре ServerInstance.

Если параметр DatabaseName не указан, используемая база данных зависит от того, указывает ли текущий путь как папку SQLSERVER:\SQL, так и имя базы данных. Если путь указывает папку SQL и имя базы данных, этот командлет подключается к базе данных, указанной в пути.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ByConnectionParameters
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-InputObject

Указывает объект управления SQL Server (SMO), представляющий базу данных, которую использует этот командлет.

Свойства параметра

Тип:Database
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ByDBObject
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Path

Указывает путь к экземпляру SQL Server, на котором выполняется операция. Если значение этого параметра не указано, командлет использует текущее рабочее расположение.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ByPath
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ServerInstance

Указывает имя экземпляра сервера (строка) или объекта SMO SQL Server Management Objects, указывающего имя экземпляра ядра СУБД. Для экземпляров по умолчанию укажите только имя компьютера: MyComputer. Для именованных экземпляров используйте формат ComputerName\InstanceName.

Свойства параметра

Тип:PSObject
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ByConnectionParameters
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SuppressProviderContextWarning

Указывает, что этот командлет подавляет предупреждение о том, что этот командлет использовался в контексте базы данных из текущего параметра пути SQLSERVER:\SQL, чтобы установить контекст базы данных для командлета.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ByContext
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

System.String

Microsoft.SqlServer.Management.Smo.Database

Выходные данные

System.Object