New-AzStorageBlobInventoryPolicyRule

Módulo:
Az.Storage Module

Crea un objeto de regla de directiva de inventario de blobs, que se puede usar en Set-AzStorageBlobInventoryPolicy.

Sintaxis

BlobRuleParameterSet (valor predeterminado) 

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

El cmdlet New-AzStorageBlobInventoryPolicyRule crea un objeto de regla de directiva de inventario de blobs, que se puede usar en Set-AzStorageBlobInventoryPolicy.

Ejemplos

Ejemplo 1: Crear objetos de regla de directiva de inventario de blobs y, a continuación, establecer la directiva de inventario de blobs con los objetos de regla.

$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...}

Estos primeros 3 comandos crean 3 objetos de regla BlobInventoryPolicy: regla "Test1" para el inventario de contenedores; regla "Test2" para el inventario de blobs; regla "Test3" para el inventario de blobs con más campos de esquema, excludePrefix especificados y IncludeDeleted habilitado. El comando siguiente establece la directiva de inventario de blobs en una cuenta de almacenamiento con los 3 objetos de regla y, a continuación, muestra las propiedades actualizadas de la directiva y las reglas.

Parámetros

-BlobSchemaField

Especifica los campos y propiedades del objeto Blob que se incluirán en el inventario. Los valores válidos incluyen: Name, Creation-Time, Last-Modified, Content-Length, Content-MD5, BlobType, AccessTier, AccessTierChangeTime, Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl, Metadata, LastAccessTime, AccessTierInferred, Tags. 'Name' es un campo de esquema obligatorio. Los valores de campo de esquema 'Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl' son válidos solo para las cuentas habilitadas para HierarchicalNamespace.'Tags' solo es válida para las cuentas que no son JerárquicasNamespace. Si especifica "-IncludeSnapshot", incluirá "Snapshot" en el inventario. Si especifica "-IncludeBlobVersion", incluirá "VersionId, "IsCurrentVersion" en el inventario.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Valores aceptados: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
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BlobRuleParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-BlobType

Establece los tipos de blob para la regla de directiva de inventario de blobs. Los valores válidos incluyen blockBlob, appendBlob, pageBlob. Las cuentas de Hns no admiten pageBlobs.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Valores aceptados:blockBlob, pageBlob, appendBlob
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BlobRuleParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ContainerSchemaField

Especifica los campos y propiedades del objeto contenedor que se incluirán en el inventario. Los valores válidos incluyen: Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold. 'Name' es un campo de esquema obligatorio.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Valores aceptados:Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ContainerRuleParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CreationTimeLastNDay

Filtre los objetos que tienen tiempo de creación en los últimos N días. El valor válido está comprendido entre 1 y 36500. El esquema de inventario "Tiempo de creación" es obligatorio con este filtro.

Propiedades de parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BlobRuleParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Destination

Nombre del contenedor donde se almacenan los archivos de inventario de blobs. Debe crearse previamente.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Disabled

La regla está deshabilitada si la establece.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ExcludePrefix

Establece una matriz de cadenas con un máximo de 10 prefijos de blobs que se excluirán del inventario.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Format

Especifica el formato de los archivos de inventario. Entre los valores posibles se incluyen: 'Csv', 'Parquet'

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Csv, Parquet
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IncludeBlobVersion

La regla está deshabilitada si la establece.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BlobRuleParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IncludeDeleted

Incluye blob eliminado en el inventario de blobs. Cuando se incluye la eliminación de blobs, para ContainerSchemaFields, debe incluir "Deleted, Version, DeletedTime y RemainingRetentionDays". Para BlobSchemaFields, en las cuentas de almacenamiento habilitadas para HNS, debe incluir "DeletedId, Deleted, DeletedTime y RemainingRetentionDays", y en las cuentas deshabilitadas de Hns debe incluir "Deleted y RemainingRetentionDays", de lo contrario, deben excluirse.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BlobRuleParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IncludeSnapshot

La regla está deshabilitada si la establece.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BlobRuleParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Un nombre de regla puede contener cualquier combinación de caracteres alfa numéricos. El nombre de regla distingue mayúsculas de minúsculas. Debe ser único dentro de una directiva.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PrefixMatch

Establece una matriz de cadenas para los prefijos de blob que se van a buscar coincidencias.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Schedule

Este campo se usa para programar una formación de inventario. Entre los valores posibles se incluyen: "Daily", "Weekly"

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Daily, Weekly
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

None

Salidas

PSBlobInventoryPolicyRule