Invoke-ComplianceSecurityFilterAction
Cette cmdlet est disponible uniquement dans le Centre de conformité et sécurité PowerShell. Si vous souhaitez en savoir plus, veuillez consulter l’article Centre de conformité et sécurité PowerShell.
Utilisez l’applet de commande Invoke-ComplianceSecurityFilterAction pour afficher et définir des limites de conformité pour les sites Microsoft OneDrive dans les organisations basées sur le cloud.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
Invoke-ComplianceSecurityFilterAction
[-Action] <String>
[[-EmailAddress] <String>]
[-PropertyName] <String>
[[-PropertyValue] <String>]
[-SiteUrl] <String>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Cette applet de commande est utile dans les scénarios où le site OneDrive a dépassé la limite de conformité en raison du départ d’un utilisateur et d’une boîte aux lettres inactive correspondante.
Pour utiliser cette applet de commande dans le PowerShell Sécurité & Conformité, vous devez être membre du groupe de rôles Administrateur de conformité. Pour plus d’informations, consultez la rubrique Autorisations dans le portail de conformité Microsoft Purview.
Exemples
Exemple 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 :
Cet exemple retourne le status d’un site OneDrive pour indiquer qu’il est associé à une boîte aux lettres d’utilisateur et que la propriété CustomAttribute1 n’est pas actuellement définie.
Exemple 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 :
Cet exemple retourne le status d’une boîte aux lettres pour indiquer que la boîte aux lettres est inactive et que la propriété CustomAttribute3 n’est pas actuellement définie.
Exemple 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
Cet exemple retourne le status d’une boîte aux lettres pour indiquer que la boîte aux lettres est inactive, et la propriété CustomAttribute3 est actuellement définie sur test33.
Exemple 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
Cet exemple définit la limite du site OneDrive spécifié pour un utilisateur qui a quitté l’entreprise.
Exemple 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
Cet exemple définit la limite du site OneDrive spécifié sur la valeur de propriété CustomAttribute3 spécifiée et exécute une autre commande pour examiner le résultat.
Paramètres
-Action
Applicable : sécurité & conformité
Le paramètre Action spécifie l’action de la commande. Les valeurs valides sont les suivantes :
- GetStatus
- Set
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : sécurité & conformité
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false. - La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-EmailAddress
Applicable : sécurité & conformité
Le paramètre EmailAddress spécifie la boîte aux lettres de l’utilisateur affectée. Vous pouvez utiliser les valeurs suivantes pour identifier de façon unique la boîte aux lettres :
- Nom
- Adresse e-mail
- Alias
- ExchangeGUID
Si la valeur contient des espaces, mettez le nom entre guillemets.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PropertyName
Applicable : sécurité & conformité
Le paramètre PropertyName spécifie le nom de la propriété de la limite de conformité du site OneDrive que vous souhaitez afficher ou modifier. Les valeurs valides sont les suivantes :
- CustomAttribute1 à CustomAttribute15
Utilisez le paramètre PropertyValue pour définir la limite de conformité.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 3 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PropertyValue
Applicable : sécurité & conformité
Le paramètre PropertyValue spécifie la valeur de PropertyName lorsque vous utilisez le paramètre Action value Set pour définir la limite de conformité d’un site OneDrive. Si la valeur contient des espaces, placez-la entre guillemets (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 4 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SiteUrl
Applicable : sécurité & conformité
Le paramètre SiteUrl spécifie le site OneDrive que vous souhaitez afficher ou modifier. Ce paramètre utilise la syntaxe https://<domain>-my.sharepoint.com/personal/<user>_<domain>_onmicrosoft_com/_layouts/15/onedrive.aspx. Par exemple : https://contoso-my.sharepoint.com/personal/lila_contoso_onmicrosoft_com/_layouts/15/onedrive.aspx.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 5 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : sécurité & conformité
Le commutateur WhatIf ne fonctionne pas dans le Centre de sécurité et de conformité PowerShell.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.