Get-Label
Этот командлет доступен только в PowerShell безопасности и соответствия требованиям. Дополнительные сведения см. в статье PowerShell безопасности и соответствия требованиям.
Используйте командлет Get-Label для просмотра меток конфиденциальности в организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Get-Label
[[-Identity] <ComplianceRuleIdParameter>]
[-IncludeDetailedLabelActions]
[-SkipValidations]
[-ReturnModernLabelScheme]
[-ValidateContentTypeRemoval]
[<CommonParameters>]
Описание
Примечание. Если в вашей организации есть более 1000 меток конфиденциальности, параметры времени ожидания, заданные для сеанса PowerShell, могут вызвать проблемы с производительностью. Используйте параметр SkipValidations для более эффективного получения меток.
Чтобы использовать этот командлет в PowerShell безопасности и соответствия требованиям, вам должны быть назначены соответствующие разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
Get-Label
В этом примере возвращается сводный список всех меток конфиденциальности в организации.
Пример 2
Get-Label -Identity "Engineering Group" | Format-List
В этом примере возвращаются подробные сведения для метки конфиденциальности с именем Engineering Group.
Параметры
-Identity
Применимо: соответствие требованиям & безопасности
Параметр Identity указывает метку конфиденциальности, которую требуется просмотреть. Вы можете использовать любое значение, однозначно определяющее метку. Например,
- имя;
- различающееся имя (DN);
- GUID
Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.
Свойства параметров
| Тип: | ComplianceRuleIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IncludeDetailedLabelActions
Применимо: соответствие требованиям & безопасности
Параметр IncludeDetailedLabelActions указывает, следует ли развертывать действия меток в свойства для повышения удобочитаемости. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ReturnModernLabelScheme
Применимо: соответствие требованиям & безопасности
{{ Fill ReturnModernLabelScheme Description }}
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SkipValidations
Применимо: соответствие требованиям & безопасности
Параметр SkipValidations указывает, следует ли пропускать извлечение свойств шифрования, настроенных в метках конфиденциальности. С этим параметром не нужно указывать значение.
Организации с более чем 1000 метками могут использовать этот параметр, чтобы сократить время, необходимое для получения меток, что помогает предотвратить проблемы с истечением времени ожидания с помощью командлета Get-Label.
Примечание. При использовании этого параметра не пропускаются проверки при получении меток. Он пропускает получение свойств шаблона шифрования, только если они настроены для метки. Эти свойства можно получить по отдельности с помощью параметра Identity в команде Get-Label.
Этот параметр не влияет на приложение меток или распределение. Ограничение существует только при выборе меток для операций CRUD.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ValidateContentTypeRemoval
Применимо: соответствие требованиям & безопасности
{{ Fill ValidateContentTypeRemoval Description }}
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.