Partager via


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

Sorties

PSBlobInventoryPolicyRule