New-AzStorageBlobInventoryPolicyRule
Crée un objet de règle de stratégie d’inventaire d’objets blob, qui peut être utilisé dans Set-AzStorageBlobInventoryPolicy.
Syntaxe
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-AzStorageBlobInventoryPolicyRule crée un objet de règle de stratégie d’inventaire d’objets blob, qui peut être utilisé dans Set-AzStorageBlobInventoryPolicy.
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 de 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[] |
Valeurs acceptées: | 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 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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[] |
Valeurs acceptées: | blockBlob, pageBlob, appendBlob |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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[] |
Valeurs acceptées: | Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Destination
Nom du conteneur où sont stockés les fichiers d’inventaire d’objets blob. Doit être précréé.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Disabled
La règle est désactivée si elle est définie.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Format
Spécifie le format des fichiers d’inventaire. Les valeurs possibles sont les suivantes : « Csv », « Parquet »
Type: | String |
Valeurs acceptées: | Csv, Parquet |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-IncludeBlobVersion
La règle est désactivée si elle est définie.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-IncludeSnapshot
La règle est désactivée si elle est définie.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-PrefixMatch
Définit un tableau de chaînes pour les préfixes d’objet blob à mettre en correspondance..
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Schedule
Ce champ est utilisé pour planifier une formation d’inventaire. Les valeurs possibles sont les suivantes : « Quotidien », « Hebdomadaire »
Type: | String |
Valeurs acceptées: | Daily, Weekly |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
Entrées
None