Dela via

New-AzStorageBlobInventoryPolicyRule

  • Referens
Modul:
Az.Storage

Skapar ett principregelobjekt för blobinventering som kan användas i Set-AzStorageBlobInventoryPolicy.

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

Cmdleten New-AzStorageBlobInventoryPolicyRule skapar ett regelobjekt för blobinventeringsprincip som kan användas i Set-AzStorageBlobInventoryPolicy.

Exempel

Exempel 1: Skapa blobinventeringsprincipregelobjekt och ange sedan blobinventeringsprincip med regelobjekten.

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

Dessa första tre kommandon skapar 3 BlobInventoryPolicy-regelobjekt: regeln "Test1" för contaienr-inventering; regel "Test2" för blobinventering; regeln "Test3" för blobinventering med fler schemafält, excludePrefix angivet och IncludeDeleted aktiverat. Följande kommando anger blobinventeringsprincipen till ett lagringskonto med 3-regelobjekten och visar sedan de uppdaterade princip- och regelegenskaperna.

Parametrar

-BlobSchemaField

Anger fälten och egenskaperna för blobobjektet som ska ingå i lagret. Giltiga värden ä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. Namn är ett obligatoriskt schemafält. Schemafältvärdena "Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl" är endast giltiga för hierarkiskaNamespace-aktiverade konton.Fältet Taggar är endast giltigt för konton som inte är HierarkiskaNamnrymdskonton. Om du anger "-IncludeSnapshot" kommer att inkludera "Snapshot" i inventeringen. Om du anger "-IncludeBlobVersion" innehåller "VersionId, "IsCurrentVersion" i inventeringen.

Typ:String[]
Godkända värden: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
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-BlobType

Anger blobtyperna för policyregeln för blobinventering. Giltiga värden är blockBlob, appendBlob, pageBlob. Hns-konton stöder inte pageBlobs.

Typ:String[]
Godkända värden:blockBlob, pageBlob, appendBlob
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ContainerSchemaField

Anger fälten och egenskaperna för containerobjektet som ska ingå i lagret. Giltiga värden är: Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold. Namn är ett obligatoriskt schemafält.

Typ:String[]
Godkända värden:Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CreationTimeLastNDay

Filtrera de objekt som har skapandetid under de senaste N dagarna. Det giltiga värdet är mellan 1 och 36500. Inventeringsschemat "Creation-Time" är obligatoriskt med det här filtret.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Destination

Containernamnet där blobinventeringsfiler lagras. Måste vara förskapad.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Disabled

Regeln inaktiveras om den anges.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ExcludePrefix

Anger en matris med strängar med högst 10 blobprefix som ska undantas från lagret.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Format

Anger formatet för inventeringsfilerna. Möjliga värden är: "Csv", "Parquet"

Typ:String
Godkända värden:Csv, Parquet
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IncludeBlobVersion

Regeln inaktiveras om den anges.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IncludeDeleted

Innehåller borttagen blob i blobinventering. När du inkluderar borttagningsblob måste för ContainerSchemaFields inkludera "Deleted, Version, DeletedTime och RemainingRetentionDays". För BlobSchemaFields, på HNS-aktiverade lagringskonton, måste inkludera "DeletionId, Deleted, DeletedTime och RemainingRetentionDays", och på Hns inaktiverade konton måste inkludera "Deleted and RemainingRetentionDays", annars måste de undantas.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IncludeSnapshot

Regeln inaktiveras om den anges.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Ett regelnamn kan innehålla valfri kombination av alfanumeriska tecken. Regelnamnet är skiftlägeskänsligt. Den måste vara unik i en princip.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PrefixMatch

Anger en matris med strängar för blobprefix som ska matchas..

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Schedule

Det här fältet används för att schemalägga en inventeringsbildning. Möjliga värden är: "Daily", "Weekly" (Varje vecka)

Typ:String
Godkända värden:Daily, Weekly
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Utdata

PSBlobInventoryPolicyRule