Invoke-ComplianceSecurityFilterAction
Этот командлет доступен только в PowerShell безопасности и соответствия требованиям. Дополнительные сведения см. в статье PowerShell безопасности и соответствия требованиям.
Используйте командлет Invoke-ComplianceSecurityFilterAction, чтобы просмотреть и задать границы соответствия для сайтов Microsoft OneDrive в облачных организациях.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Invoke-ComplianceSecurityFilterAction
[-Action] <String>
[[-EmailAddress] <String>]
[-PropertyName] <String>
[[-PropertyValue] <String>]
[-SiteUrl] <String>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Описание
Этот командлет полезен в сценариях, когда сайт OneDrive вышел за пределы соответствия требованиям из-за ушедших пользователей и соответствующего неактивного почтового ящика.
Чтобы использовать этот командлет в PowerShell для обеспечения безопасности & соответствия требованиям, необходимо быть членом группы ролей "Администратор соответствия требованиям". Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
PS C:\> Invoke-ComplianceSecurityFilterAction -Action GetStatus -PropertyName CustomAttribute1 -SiteUrl https://contoso-my.sharepoint.com/personal/lila_contoso_onmicrosoft_com/_layouts/15/onedrive.aspx
SiteUrlOrEmailAddress : https://contoso-my.sharepoint.com/personal/lila_contoso_onmicrosoft_com/_layouts/15/onedrive.aspx
BoundaryType : UserMailbox
BoundaryInstruction : Set via Set-Mailbox
BoundaryObjectId : SPO_f82ace6e-817e-4752-8917-67164dabde98@SPO_775ea11f-a2af-7821-b04c-9848e903ce47
BoundaryStatus : Success
BoundaryProperty : CustomAttribute1
BoundaryPropertyValue :
В этом примере возвращается состояние сайта OneDrive, указывающее, что он связан с почтовым ящиком пользователя, а свойство CustomAttribute1 в настоящее время не задано.
Пример 2
PS C:\> Invoke-ComplianceSecurityFi1terAction -Action GetStatus -PropertyName "CustomAttribute3" -EmailAddress "nina@contoso.onmicrosoft.com"
SiteUrlOrEmailAddress : nina@contoso.onmicrosoft.com
BoundaryType : UserMailbox
BoundaryInstruction : Set via Set-Mailbox
BoundaryObjectId : nina@contoso.onmicrosoft.com
BoundaryStatus : Success
BoundaryProperty : CustomAttribute3
BoundaryPropertyVa1ue :
В этом примере возвращается состояние почтового ящика, указывающее, что почтовый ящик неактивен, а свойство CustomAttribute3 в настоящее время не задано.
Пример 3
PS C:\> Invoke-ComplianceSecurityFi1terAction -Action GetStatus -PropertyName "CustomAttribute3" -EmailAddress "zhexuan@contoso.onmicrosoft.com"
SiteUrlOrEmailAddress : zhexuan@contoso.onmicrosoft.com
BoundaryType : InactiveMailbox
BoundaryInstruction : Set via Invoke-ComplianceSecurityFiIterAction -Set
BoundaryObjectId : zhexuan@contoso.onmicrosoft.com
BoundaryStatus : Success
BoundaryProperty : CustomAttribute3
BoundaryPropertyVa1ue : test33
В этом примере возвращается состояние почтового ящика, указывающее, что почтовый ящик неактивен, а для свойства CustomAttribute3 в настоящее время задано значение test33.
Пример 4
Invoke-ComplianceSecurityFilterAction -Action Set -PropertyName CustomAttribute1 -PropertyValue "Research and Development" -SiteUrl https://contoso-my.sharepoint.com/personal/lila_contoso_onmicrosoft_com/_layouts/15/onedrive.aspx
В этом примере задается граница указанного сайта OneDrive для пользователя, покинувшего компанию.
Пример 5
PS C:\> Invoke-ComplianceSecurityFiIterAction -Action Set -PropertyName "CustomAttribute3" -PropertyValue "ProjectX" -EmailAddress "zhexuan@contoso.onmicrosoft.com"
Set action succeeded, please use GetStatus to check the result.
PS C:\> Invoke-ComplianceSecurityFiIterAction -Action GetStatus -PropertyName "CustomAttribute3" -EmailAddress "zhexuan@contoso.onmicrosoft.com"
SiteUrlOrEmailAddress : zhexuan@contoso.onmicrosoft.com
BoundaryType : InactiveMailbox
BoundaryInstruction : Set via Invoke-ComplianceSecurityFiIterAction -Set
BoundaryObjectId : zhexuan@contoso.onmicrosoft.com
BoundaryStatus : Success
BoundaryProperty : CustomAttribute3
BoundaryPropertyVa1ue : ProjectX
В этом примере задается граница указанного сайта OneDrive для указанного значения свойства CustomAttribute3 и выполняется другая команда для проверки результата.
Параметры
-Action
Применимо: соответствие требованиям & безопасности
Параметр Action указывает действие для команды. Допустимые значения:
- GetStatus
- Set
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | 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 |
-EmailAddress
Применимо: соответствие требованиям & безопасности
Параметр EmailAddress указывает затронутый почтовый ящик пользователя. Для уникальной идентификации почтового ящика можно использовать следующие значения:
- Имя
- Адрес электронной почты
- Alias
- ExchangeGUID
Если значение содержит пробелы, его необходимо заключить в кавычки.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 2 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PropertyName
Применимо: соответствие требованиям & безопасности
Параметр PropertyName указывает имя свойства границы соответствия для сайта OneDrive, который требуется просмотреть или изменить. Допустимые значения:
- CustomAttribute1–CustomAttribute15
Используйте параметр PropertyValue, чтобы задать границу соответствия.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 3 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PropertyValue
Применимо: соответствие требованиям & безопасности
Параметр PropertyValue задает значение свойства PropertyName при использовании значения параметра Action Set для задания границы соответствия сайта OneDrive. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 4 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SiteUrl
Применимо: соответствие требованиям & безопасности
Параметр SiteUrl указывает сайт OneDrive, который нужно просмотреть или изменить. Синтаксис этого параметра: https://<domain>-my.sharepoint.com/personal/<user>_<domain>_onmicrosoft_com/_layouts/15/onedrive.aspx. Пример: https://contoso-my.sharepoint.com/personal/lila_contoso_onmicrosoft_com/_layouts/15/onedrive.aspx.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 5 |
| Обязательно: | True |
| Значение из конвейера: | 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.