New-AzStorageBlobInventoryPolicyRule

Referencia

Modul:: Az.Storage

Létrehoz egy blobleltárházirend-szabályobjektumot, amely a Set-AzStorageBlobInventoryPolicy szolgáltatásban használható.

Syntax

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

A New-AzStorageBlobInventoryPolicyRule parancsmag létrehoz egy blobleltárházirendszabály-objektumot, amely a Set-AzStorageBlobInventoryPolicy szolgáltatásban használható.

Példák

1. példa: Blobleltárszabály-szabályobjektumok létrehozása, majd blobleltárházirend beállítása a szabályobjektumokkal.

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

Ez az első 3 parancs 3 BlobInventoryPolicy szabályobjektumot hoz létre: "Test1" szabályt a contaienr-leltárhoz; blobleltár "Test2" szabálya; a blobleltár "Test3" szabálya több sémamezővel, a megadott kizárási előtaggal és az IncludeDeleted engedélyezve. Az alábbi parancs egy 3 szabályobjektumot tartalmazó Tárfiókra állítja be a blobleltár-szabályzatot, majd megjeleníti a frissített szabályzat- és szabálytulajdonságokat.

Paraméterek

-BlobSchemaField

Megadja a készletbe felvenni kívánt Blob-objektum mezőit és tulajdonságait. Az érvényes értékek a következők: Név, Létrehozás időpontja, Utolsó módosítás, Tartalomhossz, Content-MD5, BlobType, AccessTier, AccessTierChangeTime, Lejárati idő, hdi_isfolder, Tulajdonos, Csoport, Engedélyek, Acl, Metaadatok, LastAccessTime, AccessTierInferred, Címkék. A "Name" egy kötelező sémamező. A "Lejárati idő, hdi_isfolder, Tulajdonos, Csoport, Engedélyek, Acl" sémamezőértékek csak a HierarchicalNamespace-kompatibilis fiókokra érvényesek. A "Címkék" mező csak nem HierarchicalNamespace-fiókokra érvényes. Ha a "-IncludeSnapshot" értéket adja meg, a "Pillanatkép" szerepel a leltárban. Ha a "-IncludeBlobVersion" értéket adja meg, akkor a "VersionId, "IsCurrentVersion" szerepel a leltárban.

Típus:	String[]
Elfogadott értékek:	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
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-BlobType

Beállítja a blobleltárszabály blobtípusát. Az érvényes értékek a következők: blockBlob, appendBlob, pageBlob. A Hns-fiókok nem támogatják a pageBlobokat.

Típus:	String[]
Elfogadott értékek:	blockBlob, pageBlob, appendBlob
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ContainerSchemaField

Megadja a készletbe felvenni kívánt tárolóobjektum mezőit és tulajdonságait. Az érvényes értékek a következők: Név, Utolsó módosítás, Metaadatok, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold. A "Name" egy kötelező sémamező.

Típus:	String[]
Elfogadott értékek:	Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-CreationTimeLastNDay

Szűrje azokat az objektumokat, amelyek létrehozási ideje az elmúlt N napban történt. Az érvényes érték 1 és 36500 között van. Ezzel a szűrővel a készletséma létrehozási ideje kötelező.

Típus:	Int32
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Típus:	IAzureContextContainer
Aliasok:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Destination

A tároló neve, amelyben a blobleltárfájlokat tárolják. Előre létre kell hozni.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Disabled

Ha beállítja, a szabály le van tiltva.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ExcludePrefix

A készletből kizárandó legfeljebb 10 blobelőtaggal rendelkező sztringtömböt állít be.

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Format

Megadja a leltárfájlok formátumát. A lehetséges értékek a következők: "Csv", "Parquet"

Típus:	String
Elfogadott értékek:	Csv, Parquet
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-IncludeBlobVersion

Ha beállítja, a szabály le van tiltva.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-IncludeDeleted

Tartalmazza a törölt blobot a blobleltárban. Ha a törlési blobot is belefoglalja, a ContainerSchemaFields esetében tartalmaznia kell a "Törölt, Verzió, DeletedTime és RemainingRetentionDays" értéket. A BlobSchemaFields esetében a HNS-kompatibilis tárfiókokon szerepelnie kell a "DeletionId, Deleted, DeletedTime és RemainingRetentionDays" elemeknek, a Hns letiltott fiókjain pedig a "Törölt és a RemainingRetentionDays" fióknak kell szerepelnie, különben ki kell zárni őket.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-IncludeSnapshot

Ha beállítja, a szabály le van tiltva.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Name

A szabálynevek alfa numerikus karakterek tetszőleges kombinációját tartalmazhatják. A szabály neve megkülönbözteti a kis- és nagybetűk nevét. A szabályzaton belül egyedinek kell lennie.

Típus:	String
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-PrefixMatch

Sztringek tömbjének beállítása a blobelőtagok egyeztetéséhez.

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Schedule

Ez a mező készletalakítás ütemezésére szolgál. A lehetséges értékek a következők: "Napi", "Heti"

Típus:	String
Elfogadott értékek:	Daily, Weekly
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

None

Kimenetek

PSBlobInventoryPolicyRule

Megosztás a következőn keresztül:

New-AzStorageBlobInventoryPolicyRule

Syntax

Description

Példák

1. példa: Blobleltárszabály-szabályobjektumok létrehozása, majd blobleltárházirend beállítása a szabályobjektumokkal.

Paraméterek

-BlobSchemaField

-BlobType

-ContainerSchemaField

-CreationTimeLastNDay

-DefaultProfile

-Destination

-Disabled

-ExcludePrefix

-Format

-IncludeBlobVersion

-IncludeDeleted

-IncludeSnapshot

-Name

-PrefixMatch

-Schedule

Bevitelek

Kimenetek

További források