New-AzStorageBlobInventoryPolicyRule
Crea un oggetto regola dei criteri di inventario BLOB, che può essere usato in Set-AzStorageBlobInventoryPolicy.
Sintassi
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>] Descrizione
Il cmdlet New-AzStorageBlobInventoryPolicyRule crea un oggetto regola dei criteri di inventario BLOB, che può essere usato in Set-AzStorageBlobInventoryPolicy.
Esempio
Esempio 1: Creare oggetti regola dei criteri di inventario BLOB e quindi impostare i criteri di inventario BLOB con gli oggetti regola.
$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...}Questi primi 3 comandi creano 3 oggetti regola BlobInventoryPolicy: regola "Test1" per l'inventario contaienr; regola "Test2" per l'inventario BLOB; regola "Test3" per l'inventario BLOB con più campi dello schema, excludePrefix specificato e IncludeDeleted abilitato. Il comando seguente imposta i criteri di inventario BLOB su un account di archiviazione con i 3 oggetti regola, quindi mostra le proprietà aggiornate dei criteri e delle regole.
Parametri
-BlobSchemaField
Specifica i campi e le proprietà dell'oggetto BLOB da includere nell'inventario. I valori validi includono: Name, Creation-Time, Last-Modified, Content-Length, Content-MD5, BlobType, AccessTierChangeTime, Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl, Metadata, LastAccessTime, AccessTierInferred, Tags. 'Name' è un campo di schema obbligatorio. I valori dei campi schema 'Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl' sono validi solo per gli account abilitati per HierarchicalNamespace.'Tags' field is only valid for non HierarchicalNamespace accounts. Se si specifica '-IncludeSnapshot', l'inventario include 'Snapshot'. Se si specifica '-IncludeBlobVersion', includerà 'VersionId', 'IsCurrentVersion' nell'inventario.
| Tipo: | String[] |
| Valori accettati: | 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 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-BlobType
Imposta i tipi di BLOB per la regola dei criteri di inventario BLOB. I valori validi includono blockBlob, appendBlob, pageBlob. Gli account Hns non supportano pageBlobs.
| Tipo: | String[] |
| Valori accettati: | blockBlob, pageBlob, appendBlob |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ContainerSchemaField
Specifica i campi e le proprietà dell'oggetto contenitore da includere nell'inventario. I valori validi includono: Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold. 'Name' è un campo di schema obbligatorio.
| Tipo: | String[] |
| Valori accettati: | Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-CreationTimeLastNDay
Filtrare gli oggetti con ora di creazione negli ultimi N giorni. Il valore valido è compreso tra 1 e 36500. Lo schema di inventario 'Creation-Time' è obbligatorio con questo filtro.
| Tipo: | Int32 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
| Tipo: | IAzureContextContainer |
| Alias: | AzContext, AzureRmContext, AzureCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Destination
Nome del contenitore in cui vengono archiviati i file di inventario BLOB. Deve essere già creato.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Disabled
La regola è disabilitata se impostata.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ExcludePrefix
Imposta una matrice di stringhe con un massimo di 10 prefissi BLOB da escludere dall'inventario.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Format
Specifica il formato per i file di inventario. I valori possibili includono: 'Csv', 'Parquet'
| Tipo: | String |
| Valori accettati: | Csv, Parquet |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-IncludeBlobVersion
La regola è disabilitata se impostata.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-IncludeDeleted
Include BLOB eliminati nell'inventario BLOB. Quando si include il BLOB di eliminazione, per ContainerSchemaFields, deve includere 'Deleted, Version, DeletedTime e RemainingRetentionDays'. Per BlobSchemaFields, negli account di archiviazione abilitati per HNS, deve includere "DeletionId, Deleted, DeletedTime e RemainingRetentionDays" e negli account Hns disabilitati deve includere "Deleted and RemainingRetentionDays", altrimenti devono essere esclusi.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-IncludeSnapshot
La regola è disabilitata se impostata.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Name
Un nome di regola può contenere qualsiasi combinazione di caratteri alfanumerici. Il nome della regola fa distinzione tra maiuscole e minuscole. Deve essere univoco all'interno di un criterio.
| Tipo: | String |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PrefixMatch
Imposta una matrice di stringhe per i prefissi BLOB da associare.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Schedule
Questo campo viene utilizzato per pianificare una formazione di inventario. I valori possibili includono: 'Daily', 'Weekly'
| Tipo: | String |
| Valori accettati: | Daily, Weekly |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
None
