New-AzStorageBlobInventoryPolicyRule

Modul:

Az.Storage

Vytvoří objekt pravidla zásad inventáře objektů blob, který lze použít v Set-AzStorageBlobInventoryPolicy.

Syntaxe

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

Rutina New-AzStorageBlobInventoryPolicyRule vytvoří objekt pravidla zásad inventáře objektů blob, který lze použít v Set-AzStorageBlobInventoryPolicy.

Příklady

Příklad 1: Vytvořte objekty pravidel zásad inventáře objektů blob a pak nastavíte zásady inventáře objektů blob s objekty pravidel.

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

Prvních 3 příkazů vytvoří 3 objekty pravidla BlobInventoryPolicy: rule "Test1" pro inventář contaienr; pravidlo Test2 pro inventář objektů blob; Pravidlo Test3 pro inventář objektů blob s více poli schématu, zadaným parametrem excludePrefix a povolenou funkcí IncludeDeleted. Následující příkaz nastaví zásady inventáře objektů blob na účet úložiště s 3 objekty pravidel a pak zobrazí aktualizované vlastnosti zásad a pravidel.

Parametry

-BlobSchemaField

Určuje pole a vlastnosti objektu blob, které se mají zahrnout do inventáře. Mezi platné hodnoty patří: Name, Creation-Time, Last-Modified, Content-MD5, BlobType, AccessTier, AccessTierChangeTime, Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl, Metadata, LastAccessTime, AccessTierInferred, Tags. Název je požadované pole schématu. Hodnoty polí schématu Konec platnosti, hdi_isfolder, Vlastník, Skupina, Oprávnění, Seznam ACL jsou platné pouze pro účty s povolenou hodnotou HierarchicalNamespace.'Značky' jsou platné pouze pro účty mimo HierarchicalNamespace. Pokud zadáte -IncludeSnapshot, zahrne se do inventáře snímek. Pokud zadáte -IncludeBlobVersion, bude v inventáři obsahovat VersionId, IsCurrentVersion.

Typ:	String[]
Přípustné hodnoty:	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
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-BlobType

Nastaví typy objektů blob pro pravidlo zásad inventáře objektů blob. Platné hodnoty zahrnují blockBlob, appendBlob, pageBlob. Účty Hns nepodporují pageBlobs.

Typ:	String[]
Přípustné hodnoty:	blockBlob, pageBlob, appendBlob
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ContainerSchemaField

Určuje pole a vlastnosti objektu kontejneru, které se mají zahrnout do inventáře. Mezi platné hodnoty patří: Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold. Název je požadované pole schématu.

Typ:	String[]
Přípustné hodnoty:	Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CreationTimeLastNDay

Vyfiltrujte objekty, které mají čas vytvoření za posledních N dnů. Platná hodnota je v rozmezí od 1 do 36500. V tomto filtru je povinné schéma inventáře Vytvoření a čas.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Destination

Název kontejneru, ve kterém jsou uložené soubory inventáře objektů blob. Musí být předem vytvořen.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Disabled

Pravidlo je zakázané, pokud ho nastavíte.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ExcludePrefix

Nastaví pole řetězců s maximálně 10 předponami objektů blob, které se mají vyloučit z inventáře.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Format

Určuje formát souborů inventáře. Mezi možné hodnoty patří: Csv, Parquet.

Typ:	String
Přípustné hodnoty:	Csv, Parquet
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IncludeBlobVersion

Pravidlo je zakázané, pokud ho nastavíte.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IncludeDeleted

Zahrnuje odstraněný objekt blob v inventáři objektů blob. Pokud zahrnete objekt blob odstranění, musí pro ContainerSchemaFields obsahovat Odstraněné, Verze, DeletedTime a RemainingRetentionDays. V případě objektů blobSchemaFields musí v účtech úložiště s podporou HNS obsahovat odstraněné ID, Odstraněné, Odstraněné a ZbývajícíRetentionDays a v zakázaných účtech Hns musí být odstraněné a ZbývajícíRetentionDays, jinak musí být vyloučeny.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IncludeSnapshot

Pravidlo je zakázané, pokud ho nastavíte.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Název pravidla může obsahovat libovolnou kombinaci alfanumerních znaků. V názvu pravidla se rozlišují malá a velká písmena. Musí být jedinečný v rámci zásady.

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PrefixMatch

Nastaví pole řetězců pro předpony objektů blob, které se mají shodovat..

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Schedule

Toto pole slouží k naplánování inventarizace. Mezi možné hodnoty patří: "Denně", "Týdně"

Typ:	String
Přípustné hodnoty:	Daily, Weekly
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

None

Výstupy

PSBlobInventoryPolicyRule