New-AzStorageBlobInventoryPolicyRule

Module:

Az.Storage Module

Crée un objet de règle de stratégie d’inventaire d’objets blob, qui peut être utilisé dans Set-AzStorageBlobInventoryPolicy.

Syntaxe

BlobRuleParameterSet (Par défaut)

New-AzStorageBlobInventoryPolicyRule
    [-Name] <String>
    -Destination <String>
    -Format <String>
    -Schedule <String>
    -BlobSchemaField <String[]>
    -BlobType <String[]>
    [-Disabled]
    [-PrefixMatch <String[]>]
    [-ExcludePrefix <String[]>]
    [-IncludeSnapshot]
    [-IncludeBlobVersion]
    [-IncludeDeleted]
    [-CreationTimeLastNDay <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ContainerRuleParameterSet

New-AzStorageBlobInventoryPolicyRule
    [-Name] <String>
    -Destination <String>
    -Format <String>
    -Schedule <String>
    -ContainerSchemaField <String[]>
    [-Disabled]
    [-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 des conteneurs ; 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.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
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
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

BlobRuleParameterSet

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Valeurs acceptées:	blockBlob, pageBlob, appendBlob
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

BlobRuleParameterSet

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Valeurs acceptées:	Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ContainerRuleParameterSet

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	Int32
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

BlobRuleParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:	IAzureContextContainer
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

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

-Destination

Nom du conteneur où sont stockés les fichiers d’inventaire d’objets blob. Doit être précréé.

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:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Disabled

La règle est désactivée si elle est définie.

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

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

-ExcludePrefix

Définit un tableau de chaînes avec un maximum de 10 préfixes d’objet blob à exclure de l’inventaire.

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:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Format

Spécifie le format des fichiers d’inventaire. Les valeurs possibles sont les suivantes : « Csv », « Parquet »

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	Csv, Parquet
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-IncludeBlobVersion

La règle est désactivée si elle est définie.

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

Jeux de paramètres

BlobRuleParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	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.

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

Jeux de paramètres

BlobRuleParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-IncludeSnapshot

La règle est désactivée si elle est définie.

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

Jeux de paramètres

BlobRuleParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Name

Un nom de règle peut contenir n’importe quelle combinaison de caractères numériques alpha. Le nom de la règle respecte la casse. Elle doit être unique dans une stratégie.

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:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-PrefixMatch

Définit un tableau de chaînes pour les préfixes d’objet blob à mettre en correspondance..

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:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Schedule

Ce champ est utilisé pour planifier une formation d’inventaire. Les valeurs possibles sont les suivantes : « Quotidien », « Hebdomadaire »

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	Daily, Weekly
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	True
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 courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

None

Sorties

PSBlobInventoryPolicyRule