New-LabelPolicy
Этот командлет доступен только в PowerShell безопасности и соответствия требованиям. Дополнительные сведения см. в статье PowerShell безопасности и соответствия требованиям.
Используйте командлет New-LabelPolicy для создания политик меток конфиденциальности в организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (по умолчанию)
New-LabelPolicy
-Name <String>
-Labels <MultiValuedProperty>
[-AdvancedSettings <PswsHashtable>]
[-Comment <String>]
[-Confirm]
[-ExchangeAdaptiveScopes <MultiValuedProperty>]
[-ExchangeAdaptiveScopesException <MultiValuedProperty>]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeLocationException <MultiValuedProperty>]
[-Force]
[-MigrationId <String>]
[-ModernGroupLocation <MultiValuedProperty>]
[-ModernGroupLocationException <MultiValuedProperty>]
[-OneDriveLocation <MultiValuedProperty>]
[-OneDriveLocationException <MultiValuedProperty>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-PublicFolderLocation <MultiValuedProperty>]
[-Setting <PswsHashtable>]
[-Settings <PswsHashtable>]
[-SharePointLocation <MultiValuedProperty>]
[-SharePointLocationException <MultiValuedProperty>]
[-SkypeLocation <MultiValuedProperty>]
[-SkypeLocationException <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
Описание
Чтобы использовать этот командлет в PowerShell безопасности и соответствия требованиям, вам должны быть назначены соответствующие разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
New-LabelPolicy -Name "Research and Development" -Labels "R and D","R and D Management"
В этом примере создается политика меток конфиденциальности с именем Research and Development, которая содержит метки конфиденциальности с именами R и D и R and D Management.
Параметры
-AdvancedSettings
Применимо: соответствие требованиям & безопасности
Параметр AdvancedSettings включает функции и возможности для конкретного клиента для политики меток конфиденциальности.
Укажите этот параметр с помощью удостоверения (имя или GUID) политики с парами "ключ-значение" в хэш-таблице. Чтобы удалить дополнительный параметр, используйте тот же синтаксис параметра AdvancedSettings, но укажите строковое значение NULL.
Некоторые параметры, настроенные с помощью этого параметра, поддерживаются только клиентом Защита информации Microsoft Purview, а не приложениями и службами Office, поддерживающими встроенные метки. Список этих параметров см. в разделе Дополнительные параметры для клиента Защита информации Microsoft Purview.
Поддерживаемые параметры для встроенных меток:
AttachmentAction: сообщения электронной почты без метки наследуют метку с наивысшим приоритетом от вложений файлов. Задайте значение Автоматически (для автоматического применения метки) или Рекомендуется (в качестве рекомендуемого запроса пользователю). Пример:
New-LabelPolicy -Identity Global -AdvancedSettings @{AttachmentAction="Automatic"}. Дополнительные сведения об этом выборе конфигурации см. в разделе Настройка наследования меток из вложений электронной почты.EnableAudit: запретить приложениям Office отправлять данные меток конфиденциальности в решения аудита Microsoft 365. Поддерживаемые приложения: Word, Excel и PowerPoint в Windows (версия 2201+), macOS (версия 16.57+), iOS (версия 2.57+) и Android (версия 16.0.14827+); Outlook в Windows (версия 2201+), Outlook в Интернете и развертывание в macOS, iOS и Android. Пример:
New-LabelPolicy -Identity Global -AdvancedSettings @{EnableAudit="False"}.EnableRevokeGuiSupport: удалите кнопку Отслеживать & отозвать из меню конфиденциальности в клиентах Office. Поддерживаемые приложения: Word, Excel и PowerPoint в Windows (версия 2406 и выше). Пример:
New-LabelPolicy -Identity Global -AdvancedSettings @{EnableRevokeGuiSupport="False"}. Дополнительные сведения об этом выборе конфигурации см. в разделе Отслеживание и отмена доступа к документам.DisableMandatoryInOutlook: приложения Outlook, поддерживающие этот параметр, освобождают сообщения Outlook от обязательной маркировки. Пример:
New-LabelPolicy -Identity Global -AdvancedSettings @{DisableMandatoryInOutlook="True"}. Дополнительные сведения об этом выборе конфигурации см. в разделе Параметры, относящиеся к Outlook, для метки по умолчанию и обязательной маркировки.DisableShowSensitiveContent. Для приложений Office, которые выделяют конфиденциальное содержимое, из-за чего была рекомендована метка, отключите эти выделения и соответствующие указания о конфиденциальном содержимом. Дополнительные сведения см. в статье Метки конфиденциальности автоматически применяются или рекомендуются для файлов и сообщений электронной почты в Office. Поддерживаемые приложения: Word для Windows (версия 2311+). Пример:
Set-LabelPolicy -Identity Global -AdvancedSettings @{DisableShowSensitiveContent="True"}OutlookDefaultLabel: приложения Outlook, поддерживающие этот параметр, применяют метку по умолчанию или не применяют метку по умолчанию. Пример:
New-LabelPolicy -Identity Global -AdvancedSettings @{OutlookDefaultLabel="None"}. Дополнительные сведения об этом выборе конфигурации см. в разделе Параметры, относящиеся к Outlook, для метки по умолчанию и обязательной маркировки.TeamworkMandatory. Приложения Outlook и Teams, поддерживающие этот параметр, могут включать или отключать обязательные метки для собраний. Пример:
New-LabelPolicy -Identity Global -AdvancedSettings @{TeamworkMandatory="True"}. Дополнительные сведения о маркировке собраний см. в статье Использование меток конфиденциальности для защиты элементов календаря, собраний Teams и чата.teamworkdefaultlabelid. Приложения Outlook и Teams, поддерживающие этот параметр, применяют метку по умолчанию или не используют метку для собраний. Пример:
New-LabelPolicy -Identity Global -AdvancedSettings @{teamworkdefaultlabelid="General"}. Дополнительные сведения о маркировке собраний см. в статье Использование меток конфиденциальности для защиты элементов календаря, собраний Teams и чата.HideBarByDefault. Для приложений Office, поддерживающих панель конфиденциальности, не отображайте имя метки конфиденциальности в заголовке панели окна, чтобы было больше места для отображения длинных имен файлов. Отображаются только значок метки и цвет (при настройке). Пользователи не могут отменить изменения этот параметр в приложении. Пример:
New-LabelPolicy -Identity Global -AdvancedSettings @{HideBarByDefault="True"}
Кроме того, для Power BI:
powerbimandatory: обязательная маркировка для Power BI. Пример:
New-LabelPolicy -Identity Global -AdvancedSettings @{powerbimandatory="true"}. Дополнительные сведения об этом выборе конфигурации см. в статье Обязательная политика меток для Power BI.powerbidefaultlabelid: метка по умолчанию для содержимого Power BI. Пример:
New-LabelPolicy -Identity Global -AdvancedSettings @{powerbidefaultlabelid="General"}. Дополнительные сведения об этом выборе конфигурации см. в статье Политика меток по умолчанию для Power BI.
Свойства параметра
| Тип: | PswsHashtable |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Comment
Применимо: соответствие требованиям & безопасности
Параметр Comment указывает необязательный комментарий. Если вы указываете значение, содержащее пробелы, заключите его в кавычки ("), например:" Это примечание администратора ".
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: соответствие требованиям & безопасности
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExchangeAdaptiveScopes
Применимо: соответствие требованиям & безопасности
{{ Fill ExchangeAdaptiveScopes Description }}
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExchangeAdaptiveScopesException
Применимо: соответствие требованиям & безопасности
{{ Fill ExchangeAdaptiveScopesException Description }}
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExchangeLocation
Применимо: соответствие требованиям & безопасности
Параметр ExchangeLocation указывает почтовые ящики для включения в политику. Допустимым значением является почтовый ящик.
Чтобы указать почтовый ящик, можно использовать любое значение, которое однозначно его идентифицирует. Например:
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExchangeLocationException
Применимо: соответствие требованиям & безопасности
Параметр ExchangeLocationException указывает почтовые ящики, которые следует исключить при использовании значения All для параметра ExchangeLocation. Допустимым значением является почтовый ящик.
Чтобы указать почтовый ящик, можно использовать любое значение, которое однозначно его идентифицирует. Например:
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Применимо: соответствие требованиям & безопасности
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Labels
Применимо: соответствие требованиям & безопасности
Параметр Labels указывает метки конфиденциальности, связанные с политикой. Вы можете использовать любое значение, однозначно определяющее метку. Например,
- имя;
- различающееся имя (DN);
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MigrationId
Применимо: соответствие требованиям & безопасности
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ModernGroupLocation
Применимо: соответствие требованиям & безопасности
Параметр ModernGroupLocation указывает Группы Microsoft 365 для включения в политику. Чтобы определить группу Microsoft 365, необходимо использовать основной SMTP-адрес.
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Default
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ModernGroupLocationException
Применимо: соответствие требованиям & безопасности
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Default
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Применимо: соответствие требованиям & безопасности
Параметр Name указывает уникальное имя политики. Максимальная длина: 64 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OneDriveLocation
Применимо: соответствие требованиям & безопасности
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OneDriveLocationException
Применимо: соответствие требованиям & безопасности
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PolicyRBACScopes
Применимо: соответствие требованиям & безопасности
Параметр PolicyRBACScopes указывает административные единицы, назначаемого политике. Допустимым значением является Microsoft Entra ObjectID (значение GUID) административной единицы. Вы можете указать несколько значений, разделив их запятыми.
Административные единицы доступны только в Microsoft Entra идентификатором P1 или P2. Вы создаете административные единицы и управляете ими в Microsoft Graph PowerShell.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PublicFolderLocation
Применимо: соответствие требованиям & безопасности
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Setting
Применимо: соответствие требованиям & безопасности
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметра
| Тип: | PswsHashtable |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Settings
Применимо: соответствие требованиям & безопасности
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметра
| Тип: | PswsHashtable |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SharePointLocation
Применимо: соответствие требованиям & безопасности
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SharePointLocationException
Применимо: соответствие требованиям & безопасности
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SkypeLocation
Применимо: соответствие требованиям & безопасности
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SkypeLocationException
Применимо: соответствие требованиям & безопасности
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: соответствие требованиям & безопасности
Параметр WhatIf не поддерживается в PowerShell безопасности и соответствия требованиям.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.