Invoke-ComplianceSecurityFilterAction
Este cmdlet está disponível apenas no PowerShell de Segurança e Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..
Utilize o cmdlet Invoke-ComplianceSecurityFilterAction para ver e definir limites de conformidade para sites do Microsoft OneDrive em organizações baseadas na cloud.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
Invoke-ComplianceSecurityFilterAction
[-Action] <String>
[[-EmailAddress] <String>]
[-PropertyName] <String>
[[-PropertyValue] <String>]
[-SiteUrl] <String>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Este cmdlet é útil em cenários em que o site do OneDrive saiu do limite de conformidade devido a um utilizador falecido e a uma caixa de correio inativa correspondente.
Para utilizar este cmdlet no PowerShell de Conformidade do & de Segurança, tem de ser membro do grupo de funções Administrador de Conformidade. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.
Exemplos
Exemplo 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 :
Este exemplo devolve o status de um site do OneDrive para indicar que está associado a uma caixa de correio de utilizador e que a propriedade CustomAttribute1 não está atualmente definida.
Exemplo 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 :
Este exemplo devolve a status de uma caixa de correio para indicar que a caixa de correio está inativa e que a propriedade CustomAttribute3 não está atualmente definida.
Exemplo 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
Este exemplo devolve a status de uma caixa de correio para indicar que a caixa de correio está inativa e a propriedade CustomAttribute3 está atualmente definida como test33.
Exemplo 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
Este exemplo define o limite do site do OneDrive especificado para um utilizador que saiu da empresa.
Exemplo 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
Este exemplo define o limite do site do OneDrive especificado para o valor de propriedade CustomAttribute3 especificado e executa outro comando para rever o resultado.
Parâmetros
-Action
Aplicável: Conformidade do & de Segurança
O parâmetro Ação especifica a ação para o comando . Os valores válidos são:
- GetStatus
- Conjunto
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Conformidade do & de Segurança
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-EmailAddress
Aplicável: Conformidade do & de Segurança
O parâmetro EmailAddress especifica a caixa de correio do utilizador afetado. Pode utilizar os seguintes valores para identificar exclusivamente a caixa de correio:
- Nome
- Endereço de email
- Alias
- ExchangeGUID
Se o valor contiver espaços, coloque-o entre aspas.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PropertyName
Aplicável: Conformidade do & de Segurança
O parâmetro PropertyName especifica o nome da propriedade do limite de conformidade do site do OneDrive que pretende ver ou modificar. Os valores válidos são:
- CustomAttribute1 to CustomAttribute15
Utilize o parâmetro PropertyValue para definir o limite de conformidade.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 3 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PropertyValue
Aplicável: Conformidade do & de Segurança
O parâmetro PropertyValue especifica o valor do valor PropertyName quando utiliza o valor do parâmetro Ação Definido para definir o limite de compatibilidade de um site do OneDrive. Se o valor contiver espaços, coloque-o entre aspas (").
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 4 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SiteUrl
Aplicável: Conformidade do & de Segurança
O parâmetro SiteUrl especifica o site do OneDrive que pretende ver ou modificar. Esse parâmetro usa a sintaxe https://<domain>-my.sharepoint.com/personal/<user>_<domain>_onmicrosoft_com/_layouts/15/onedrive.aspx. Por exemplo: https://contoso-my.sharepoint.com/personal/lila_contoso_onmicrosoft_com/_layouts/15/onedrive.aspx.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 5 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Conformidade do & de Segurança
A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.