Aracılığıyla paylaş

New-AzStorageBlobInventoryPolicyRule

  • Başvuru
Modül:
Az.Storage

Set-AzStorageBlobInventoryPolicy içinde kullanılabilen bir blob envanter ilkesi kuralı nesnesi oluşturur.

Sözdizimi

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

New-AzStorageBlobInventoryPolicyRule cmdlet'i, Set-AzStorageBlobInventoryPolicy içinde kullanılabilecek bir blob envanter ilkesi kuralı nesnesi oluşturur.

Örnekler

Örnek 1: Blob envanter ilkesi kural nesneleri oluşturun ve ardından kural nesneleriyle blob envanter ilkesini ayarlar.

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

Bu ilk 3 komut 3 BlobInventoryPolicy kural nesnesi oluşturur: contaienr envanteri için kural "Test1"; blob envanteri için kural "Test2"; daha fazla şema alanı, excludePrefix belirtilen ve IncludeDeleted etkin olan blob envanteri için kural "Test3". Aşağıdaki komut blob envanter ilkesini 3 kural nesnesiyle bir Depolama hesabına ayarlar ve ardından güncelleştirilmiş ilke ve kural özelliklerini gösterir.

Parametreler

-BlobSchemaField

Envantere eklenecek Blob nesnesinin alanlarını ve özelliklerini belirtir. Geçerli değerler şunlardır: 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' gerekli bir şema alanıdır. 'Süre Sonu-Zamanı, hdi_isfolder, Sahip, Grup, İzinler, Acl' şema alanı değerleri yalnızca HiyerarşikNamespace özellikli hesaplar için geçerlidir.'Etiketler' alanı yalnızca Hiyerarşik Ad alanı olmayan hesaplar için geçerlidir. '-IncludeSnapshot' belirtilmesi durumunda envantere 'Snapshot' eklenecektir. '-IncludeBlobVersion' belirtilirse, envantere 'VersionId, 'IsCurrentVersion' eklenir.

Tür:String[]
Kabul edilen değerler: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
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-BlobType

Blob envanter ilkesi kuralı için blob türlerini ayarlar. Geçerli değerler arasında blockBlob, appendBlob, pageBlob bulunur. Hns hesapları pageBlobs'ları desteklemez.

Tür:String[]
Kabul edilen değerler:blockBlob, pageBlob, appendBlob
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ContainerSchemaField

Envantere dahil edilecek kapsayıcı nesnesinin alanlarını ve özelliklerini belirtir. Geçerli değerler şunlardır: Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold. 'Name' gerekli bir şema alanıdır.

Tür:String[]
Kabul edilen değerler:Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CreationTimeLastNDay

Son N gün içinde oluşturma zamanı olan nesneleri filtreleyin. Geçerli değer 1 ile 36500 arasındadır. Bu filtrede 'Oluşturma Zamanı' envanter şeması zorunludur.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Destination

Blob envanter dosyalarının depolandığı kapsayıcı adı. Önceden oluşturulmalıdır.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Disabled

Kural ayarlanırsa devre dışı bırakılır.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ExcludePrefix

Envanterin dışında tutulacak en fazla 10 blob ön ekine sahip dize dizisini ayarlar.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Format

Envanter dosyalarının biçimini belirtir. Olası değerler şunlardır: 'Csv', 'Parquet'

Tür:String
Kabul edilen değerler:Csv, Parquet
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IncludeBlobVersion

Kural ayarlanırsa devre dışı bırakılır.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IncludeDeleted

Blob envanterinde silinen blobu içerir. Sil blobu dahil edildiğinde ContainerSchemaFields için 'Deleted, Version, DeletedTime ve RemainingRetentionDays' içermelidir. BlobSchemaFields için, HNS özellikli depolama hesaplarında 'DeletionId, Deleted, DeletedTime ve RemainingRetentionDays' ve Hns devre dışı bırakılmış hesaplarda 'Deleted ve RemainingRetentionDays' bulunmalıdır, aksi halde bunların dışlanması gerekir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IncludeSnapshot

Kural ayarlanırsa devre dışı bırakılır.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Name

Kural adı, alfa sayısal karakterlerin herhangi bir bileşimini içerebilir. Kural adı büyük/küçük harfe duyarlıdır. İlke içinde benzersiz olmalıdır.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PrefixMatch

Blob ön eklerinin eşleştirileceği dize dizisini ayarlar..

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Schedule

Bu alan, stok oluşumunu zamanlamak için kullanılır. Olası değerler şunlardır: 'Günlük', 'Haftalık'

Tür:String
Kabul edilen değerler:Daily, Weekly
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

None

Çıkışlar

PSBlobInventoryPolicyRule