Set-DataEncryptionPolicy
Этот командлет доступен только в облачной службе.
Используйте командлет Set-DataEncryptionPolicy для изменения политик шифрования данных в Exchange Online.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Set-DataEncryptionPolicy
[-Identity] <DataEncryptionPolicyIdParameter>
-PermanentDataPurgeReason <String>
[-PermanentDataPurgeContact <String>]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Force]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
Set-DataEncryptionPolicy
[-Identity] <DataEncryptionPolicyIdParameter>
-PermanentDataPurgeContact <String>
-PermanentDataPurgeReason <String>
[-PermanentDataPurgeRequested]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Force]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
Set-DataEncryptionPolicy
[-Identity] <DataEncryptionPolicyIdParameter>
[-Refresh]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
Описание
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Set-DataEncryptionPolicy -Identity "US Mailboxes" -Enabled $false
В этом примере отключается политика шифрования данных с именем US Mailboxes.
Пример 2
Set-DataEncryptionPolicy -Identity "Europe Mailboxes" -Refresh
В этом примере обновляется политика шифрования данных с именем Почтовые ящики Европы после смены одного из связанных ключей в Key Vault Azure.
Параметры
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false
. - Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Description
Параметр Description задает необязательное описание политики шифрования данных. Если значение содержит пробелы, его необходимо заключить в кавычки.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-DomainController
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Enabled
Параметр Enabled включает или отключает политику шифрования данных. Допустимые значения:
- $true. Политика включена.
- $true. Политика включена. Это значение задается по умолчанию.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Force
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Используйте этот параметр, чтобы удалить все данные, зашифрованные политикой шифрования данных (параметр PermanentDataPurgeRequested), но связанный Key Vault Azure также был удален.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Identity
Параметр Identity указывает политику шифрования данных, которую требуется изменить. Вы можете использовать любое уникальное значение, определяющее политику. Например:
- имя;
- различающееся имя (DN);
- GUID
Type: | DataEncryptionPolicyIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Name
Параметр Name задает уникальное имя политики шифрования данных. Если значение содержит пробелы, его необходимо заключить в кавычки.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-PermanentDataPurgeContact
Параметр PermanentDataPurgeContact задает контакт для очистки всех данных, зашифрованных политикой шифрования данных. Если значение содержит пробелы, его необходимо заключить в кавычки.
Этот параметр необходимо использовать вместе с параметрами PermanentDataPurgeRequested и PermanentDataPurgeReason.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-PermanentDataPurgeReason
Параметр PermanentDataPurgeReason указывает описательную причину очистки всех данных, зашифрованных политикой шифрования данных. Если значение содержит пробелы, его необходимо заключить в кавычки.
Этот параметр необходимо использовать вместе с параметрами PermanentDataPurgeRequested и PermanentDataPurgeContact.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-PermanentDataPurgeRequested
Параметр PermanentDataPurgeRequested указывает, следует ли инициировать удаление всех данных, зашифрованных политикой шифрования данных. Указывать значение для этого параметра необязательно.
Этот переключатель необходимо использовать вместе с параметрами PermanentDataPurgeReason и PermanentDataPurgeContact.
После использования этого параметра политику шифрования данных невозможно будет назначить другим почтовым ящикам.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Refresh
Используйте параметр Обновить, чтобы обновить политику шифрования данных в Exchange Online после смены любого из связанных ключей в Key Vault Azure. Указывать значение для этого параметра необязательно.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-WhatIf
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |