New-AzStorageBlobInventoryPolicyRule

Module:

Az.Storage

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

PSBlobInventoryPolicyRule