New-AzStorageBlobInventoryPolicyRule
Crée un objet de règle de stratégie d’inventaire d’objets blob, qui peut être utilisé dans Set-Az Stockage BlobInventoryPolicy.
Syntax
New-AzStorageBlobInventoryPolicyRule
[-Name] <String>
[-Disabled]
-Destination <String>
-Format <String>
-Schedule <String>
-BlobSchemaField <String[]>
-BlobType <String[]>
[-PrefixMatch <String[]>]
[-ExcludePrefix <String[]>]
[-IncludeSnapshot]
[-IncludeBlobVersion]
[-IncludeDeleted]
[-CreationTimeLastNDay <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzStorageBlobInventoryPolicyRule
[-Name] <String>
[-Disabled]
-Destination <String>
-Format <String>
-Schedule <String>
-ContainerSchemaField <String[]>
[-PrefixMatch <String[]>]
[-ExcludePrefix <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
L’applet de commande New-Az Stockage BlobInventoryPolicyRule crée un objet de règle de stratégie d’inventaire d’objets blob, qui peut être utilisé dans Set-Az Stockage BlobInventoryPolicy.
Exemples
Exemple 1 : Créez des objets de règle de stratégie d’inventaire d’objets blob, puis définissez la stratégie d’inventaire d’objets blob avec les objets de règle.
$rule1 = New-AzStorageBlobInventoryPolicyRule -Name Test1 -Destination $containerName -Disabled -Format Csv -Schedule Daily -ContainerSchemaField Name,Metadata,PublicAccess,Last-mOdified,LeaseStatus,LeaseState,LeaseDuration,HasImmutabilityPolicy,HasLegalHold -PrefixMatch con1,con2
$rule2 = New-AzStorageBlobInventoryPolicyRule -Name Test2 -Destination $containerName -Format Parquet -Schedule Weekly -IncludeSnapshot -BlobType blockBlob,appendBlob -PrefixMatch aaa,bbb `
-BlobSchemaField name,Creation-Time,Last-Modified,Content-Length,Content-MD5,BlobType,AccessTier,AccessTierChangeTime,Expiry-Time,hdi_isfolder,Owner,Group,Permissions,Acl,Metadata -CreationTimeLastNDay 30
$rule3 = New-AzStorageBlobInventoryPolicyRule -Name Test3 -Destination $containerName -Format Parquet -Schedule Weekly -IncludeSnapshot -IncludeDeleted -BlobType blockBlob,appendBlob -PrefixMatch aaa,bbb `
-ExcludePrefix ccc,ddd -BlobSchemaField name,Last-Modified,BlobType,AccessTier,AccessTierChangeTime,Content-Type,Content-CRC64,CopyId,DeletionId,Deleted,DeletedTime,RemainingRetentionDays
$policy = Set-AzStorageBlobInventoryPolicy -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -Disabled -Rule $rule1,$rule2
$policy
StorageAccountName : mystorageaccount
ResourceGroupName : myresourcegroup
Name : DefaultInventoryPolicy
Id : /subscriptions/{subscription-Id}/resourceGroups/myresourcegroup/providers/Microsoft.Storage/storageAccounts/mystorageaccount/inventoryPolicies/default
Type : Microsoft.Storage/storageAccounts/inventoryPolicies
LastModifiedTime : 5/12/2021 8:53:38 AM
Enabled : False
Rules : {Test1, Test2, Test3}
$policy.Rules
Name Enabled Destination ObjectType Format Schedule IncludeSnapshots IncludeBlobVersions IncludeDeleted BlobTypes PrefixMatch ExcludePrefix SchemaFields CreationTime
---- ------- ----------- ---------- ------ -------- ---------------- ------------------- -------------- --------- ----------- ------------- ------------ ------------
Test1 False containername Container Csv Daily {con1, con2} {Name, Metadata, PublicAccess, Last-Modified...}
Test2 True containername Blob Parquet Weekly True {blockBlob, appendBlob} {aaa, bbb} {Name, Creation-Time, Last-Modified, Content-Length...} LastNDays=30
Test3 True containername Blob Parquet Weekly True True {blockBlob, appendBlob} {aaa, bbb} {ccc, ddd} {Name, Last-Modified, BlobType, AccessTier...}
Ces 3 premières commandes créent 3 objets de règle BlobInventoryPolicy : règle « Test1 » pour l’inventaire contaienr ; règle « Test2 » pour l’inventaire des objets blob ; règle « Test3 » pour l’inventaire d’objets blob avec plus de champs de schéma, excludePrefix spécifié et IncludeDeleted activé. La commande suivante définit la stratégie d’inventaire d’objets blob sur un compte Stockage avec les 3 objets de règle, puis affiche les propriétés de stratégie et de règles mises à jour.
Paramètres
-BlobSchemaField
Spécifie les champs et les propriétés de l’objet Blob à inclure dans l’inventaire. Les valeurs valides sont les suivantes : Name, Creation-Time, Last-Modified, Content-Length, Content-MD5, BlobType, AccessTierChangeTime, Expirey-Time, hdi_isfolder, Owner, Group, Permissions, Acl, Metadata, LastAccessTime, AccessTierInferred, Tags. 'Name' est un champ de schéma requis. Les valeurs des champs de schéma « Expiration-Heure, hdi_isfolder, Propriétaire, Groupe, Autorisations, Acl » sont valides uniquement pour les comptes enabled HierarchicalNamespace. Le champ Tags n’est valide que pour les comptes non HierarchicalNamespace. Si vous spécifiez « -IncludeSnapshot », incluez « Snapshot » dans l’inventaire. Si vous spécifiez « -IncludeBlobVersion », incluez « VersionId, « IsCurrentVersion » dans l’inventaire.
Type: | String[] |
Accepted values: | Name, Creation-Time, Last-Modified, Content-Length, Content-MD5, BlobType, AccessTier, AccessTierChangeTime, Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl, Metadata, LastAccessTime, AccessTierInferred, Tags, Etag, Content-Type, Content-Encoding, Content-Language, Content-CRC64, Cache-Control, Content-Disposition, LeaseStatus, LeaseState, LeaseDuration, ServerEncrypted, Deleted, RemainingRetentionDays, ImmutabilityPolicyUntilDate, ImmutabilityPolicyMode, LegalHold, CopyId, CopyStatus, CopySource, CopyProgress, CopyCompletionTime, CopyStatusDescription, CustomerProvidedKeySha256, RehydratePriority, ArchiveStatus, x-ms-blob-sequence-number, EncryptionScope, IncrementalCopy, DeletionId, DeletedTime, TagCount |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BlobType
Définit les types d’objets blob pour la règle de stratégie d’inventaire d’objets blob. Les valeurs valides incluent blockBlob, appendBlob, pageBlob. Les comptes Hns ne prennent pas en charge pageBlobs.
Type: | String[] |
Accepted values: | blockBlob, pageBlob, appendBlob |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContainerSchemaField
Spécifie les champs et les propriétés de l’objet conteneur à inclure dans l’inventaire. Les valeurs valides sont les suivantes : Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold. 'Name' est un champ de schéma requis.
Type: | String[] |
Accepted values: | Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CreationTimeLastNDay
Filtrez les objets qui ont l’heure de création dans les derniers jours N. La valeur valide est comprise entre 1 et 36500. Le schéma d’inventaire « Temps de création » est obligatoire avec ce filtre.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Destination
Nom du conteneur où sont stockés les fichiers d’inventaire d’objets blob. Doit être précréé.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disabled
La règle est désactivée si elle est définie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludePrefix
Définit un tableau de chaînes avec un maximum de 10 préfixes d’objet blob à exclure de l’inventaire.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Format
Spécifie le format des fichiers d’inventaire. Les valeurs possibles sont les suivantes : « Csv », « Parquet »
Type: | String |
Accepted values: | Csv, Parquet |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeBlobVersion
La règle est désactivée si elle est définie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeDeleted
Inclut l’objet blob supprimé dans l’inventaire des objets blob. Lorsque l’objet blob include delete, pour ContainerSchemaFields, doit inclure « Deleted, Version, DeletedTime et RemainingRetentionDays ». Pour BlobSchemaFields, sur les comptes de stockage HNS activés, doit inclure « LetedId, DeletedTime et RemainingRetentionDays », et sur les comptes désactivés Hns doivent inclure « Deleted et RemainingRetentionDays », sinon ils doivent être exclus.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeSnapshot
La règle est désactivée si elle est définie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Un nom de règle peut contenir n’importe quelle combinaison de caractères alphanumériques. Les noms de règle respectent la casse. Ils doivent être uniques dans la stratégie.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrefixMatch
Définit un tableau de chaînes pour les préfixes d’objet blob à mettre en correspondance..
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Schedule
Ce champ est utilisé pour planifier une formation d’inventaire. Les valeurs possibles sont les suivantes : « Quotidien », « Hebdomadaire »
Type: | String |
Accepted values: | Daily, Weekly |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
None
Sorties
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour