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