New-AzStorageBlobInventoryPolicyRule

Modul:

Az.Storage

Membuat objek aturan kebijakan inventaris blob, yang dapat digunakan dalam Set-AzStorageBlobInventoryPolicy.

Sintaks

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>]

Deskripsi

Cmdlet New-AzStorageBlobInventoryPolicyRule membuat objek aturan kebijakan inventaris blob, yang dapat digunakan dalam Set-AzStorageBlobInventoryPolicy.

Contoh

Contoh 1: Buat objek aturan kebijakan inventaris blob, lalu tetapkan kebijakan inventaris blob dengan objek aturan.

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

3 perintah pertama ini membuat 3 objek aturan BlobInventoryPolicy: aturan "Test1" untuk inventaris contaienr; aturan "Test2" untuk inventaris blob; aturan "Test3" untuk inventaris blob dengan lebih banyak bidang skema, excludePrefix yang ditentukan, dan IncludeDeleted diaktifkan. Perintah berikut menetapkan kebijakan inventaris blob ke akun Storage dengan 3 objek aturan, lalu menampilkan properti kebijakan dan aturan yang diperbarui.

Parameter

-BlobSchemaField

Menentukan bidang dan properti objek Blob yang akan disertakan dalam inventori. Nilai yang valid meliputi: Nama, Creation-Time, Last-Modified, Content-Length, Content-MD5, BlobType, AccessTier, AccessTierChangeTime, Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl, Metadata, LastAccessTime, AccessTierInferred, Tags. 'Nama' adalah skema yang diperlukan. Nilai bidang skema 'Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl' hanya valid untuk akun yang diaktifkan HierarchicalNamespace.'Tags' hanya valid untuk akun non HierarchicalNamespace. Jika menentukan '-IncludeSnapshot', akan menyertakan 'Rekam Jepret' dalam inventori. Jika menentukan '-IncludeBlobVersion', akan menyertakan 'VersionId, 'IsCurrentVersion' dalam inventori.

Jenis:	String[]
Nilai yang diterima:	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
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-BlobType

Mengatur jenis blob untuk aturan kebijakan inventaris blob. Nilai yang valid termasuk blockBlob, appendBlob, pageBlob. Akun Hns tidak mendukung pageBlobs.

Jenis:	String[]
Nilai yang diterima:	blockBlob, pageBlob, appendBlob
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-ContainerSchemaField

Menentukan bidang dan properti objek kontainer yang akan disertakan dalam inventori. Nilai yang valid meliputi: Nama, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold. 'Nama' adalah skema yang diperlukan.

Jenis:	String[]
Nilai yang diterima:	Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-CreationTimeLastNDay

Filter objek yang memiliki waktu pembuatan dalam N hari terakhir. Nilai yang valid adalah antara 1 hingga 36500. Skema inventori 'Creation-Time' wajib dilakukan dengan filter ini.

Jenis:	Int32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Destination

Nama kontainer tempat file inventori blob disimpan. Harus dibuat sebelumnya.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-Disabled

Aturan dinonaktifkan jika diatur.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ExcludePrefix

Mengatur array string dengan maksimum 10 awalan blob yang akan dikecualikan dari inventaris.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Format

Menentukan format untuk file inventori. Nilai yang mungkin termasuk: 'Csv', 'Parquet'

Jenis:	String
Nilai yang diterima:	Csv, Parquet
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-IncludeBlobVersion

Aturan dinonaktifkan jika diatur.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-IncludeDeleted

Termasuk blob yang dihapus dalam inventaris blob. Saat menyertakan hapus blob, untuk ContainerSchemaFields, harus menyertakan 'Dihapus, Versi, DeletedTime dan RemainingRetentionDays'. Untuk BlobSchemaFields, pada akun penyimpanan yang diaktifkan HNS, harus menyertakan 'DeletionId, DeletedTime, dan RemainingRetentionDays', dan pada akun yang dinonaktifkan HNS harus menyertakan 'Deleted dan RemainingRetentionDays', jika tidak, akun tersebut harus dikecualikan.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-IncludeSnapshot

Aturan dinonaktifkan jika diatur.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Name

Nama aturan dapat berisi kombinasi karakter alfa numerik apa pun. Nama aturannya peka huruf besar/kecil. Itu harus unik dalam sebuah kebijakan.

Jenis:	String
Position:	0
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-PrefixMatch

Mengatur array string untuk awalan blob yang akan dicocokkan..

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Schedule

Bidang ini digunakan untuk menjadwalkan pembentukan inventarisi. Nilai yang mungkin termasuk: 'Harian', 'Mingguan'

Jenis:	String
Nilai yang diterima:	Daily, Weekly
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

Input

None

Output

PSBlobInventoryPolicyRule