New-AzStorageBlobInventoryPolicyRule

Odwołanie

Moduł:: Az.Storage

Tworzy obiekt reguły zasad spisu obiektów blob, który może być używany w elemecie Set-AzStorageBlobInventoryPolicy.

Składnia

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

Opis

Polecenie cmdlet New-AzStorageBlobInventoryPolicyRule tworzy obiekt reguł zasad spisu obiektów blob, którego można użyć w elemecie Set-AzStorageBlobInventoryPolicy.

Przykłady

Przykład 1: Tworzenie obiektów reguł zasad spisu obiektów blob, a następnie ustawianie zasad spisu obiektów blob za pomocą obiektów reguł.

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

Te pierwsze 3 polecenia tworzą 3 obiekty reguły BlobInventoryPolicy: reguła "Test1" dla spisu contaienr; reguła "Test2" dla spisu obiektów blob; reguła "Test3" dla spisu obiektów blob z większą większa liczba pól schematu, określona wartość excludePrefix i enabled IncludeDeleted. Następujące polecenie ustawia zasady spisu obiektów blob na konto magazynu z 3 obiektami reguły, a następnie wyświetla zaktualizowane właściwości zasad i reguł.

Parametry

-BlobSchemaField

Określa pola i właściwości obiektu blob, które mają być uwzględnione w spisie. Prawidłowe wartości to: Name, Creation-Time, Last-Modified, Content-Length, Content-MD5, BlobType, AccessTier, AccessTierChangeTime, Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl, Metadata, LastAccessTime, AccessTierInferred, Tags. Pole schematu "Name" jest wymagane. Wartości pól schematu "Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl" są prawidłowe tylko dla kont z włączoną hierarchiczną przestrzenią nazw.'Tagi' pole jest prawidłowe tylko dla kont nie hierarchicznychNamespace. Jeśli określisz wartość "-IncludeSnapshot", dołączy element "Snapshot" do spisu. Jeśli określisz wartość "-IncludeBlobVersion", w spisie uwzględnisz ciąg "VersionId, "IsCurrentVersion".

Typ:	String[]
Dopuszczalne wartości:	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
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-BlobType

Ustawia typy obiektów blob dla reguły zasad spisu obiektów blob. Prawidłowe wartości obejmują blockBlob, appendBlob, pageBlob. Konta Hns nie obsługują stronicowych obiektów Blob.

Typ:	String[]
Dopuszczalne wartości:	blockBlob, pageBlob, appendBlob
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ContainerSchemaField

Określa pola i właściwości obiektu kontenera, które mają być uwzględnione w spisie. Prawidłowe wartości to: Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold. Pole schematu "Name" jest wymagane.

Typ:	String[]
Dopuszczalne wartości:	Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CreationTimeLastNDay

Przefiltruj obiekty, które mają czas tworzenia w ciągu ostatnich N dni. Prawidłowa wartość to od 1 do 36500. Schemat spisu "Czas tworzenia" jest obowiązkowy z tym filtrem.

Typ:	Int32
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Destination

Nazwa kontenera, w którym są przechowywane pliki spisu obiektów blob. Należy wstępnie utworzyć.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Disabled

Reguła jest wyłączona, jeśli ją ustawisz.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ExcludePrefix

Ustawia tablicę ciągów z maksymalnie 10 prefiksami obiektów blob do wykluczenia ze spisu.

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Format

Określa format plików spisu. Możliwe wartości to: "Csv", "Parquet"

Typ:	String
Dopuszczalne wartości:	Csv, Parquet
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-IncludeBlobVersion

Reguła jest wyłączona, jeśli ją ustawisz.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-IncludeDeleted

Obejmuje usunięty obiekt blob w spisie obiektów blob. W przypadku dołączania usuwania obiektu blob dla pola ContainerSchemaFields musi zawierać wartość "Deleted, Version, DeletedTime i RemainingRetentionDays". W przypadku obiektów BlobSchemaFields na kontach magazynu z włączoną obsługą usługi HNS muszą zawierać wartości "DeletionId, DeletedTime i RemainingRetentionDays" oraz na kontach wyłączonych Hns muszą zawierać wartości "Deleted i RemainingRetentionDays", w przeciwnym razie muszą być wykluczone.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-IncludeSnapshot

Reguła jest wyłączona, jeśli ją ustawisz.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Name

Nazwa reguły może zawierać dowolną kombinację znaków alfanumerycznych. W nazwie reguły jest rozróżniana wielkość liter. Musi być unikatowa w ramach zasad.

Typ:	String
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-PrefixMatch

Ustawia tablicę ciągów dla prefiksów obiektów blob, które mają być dopasowane.

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Schedule

To pole służy do planowania tworzenia spisu. Możliwe wartości to: "Codziennie", "Co tydzień"

Typ:	String
Dopuszczalne wartości:	Daily, Weekly
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

None

Dane wyjściowe

PSBlobInventoryPolicyRule

Udostępnij za pośrednictwem

New-AzStorageBlobInventoryPolicyRule

Składnia

Opis

Przykłady

Przykład 1: Tworzenie obiektów reguł zasad spisu obiektów blob, a następnie ustawianie zasad spisu obiektów blob za pomocą obiektów reguł.

Parametry

-BlobSchemaField

-BlobType

-ContainerSchemaField

-CreationTimeLastNDay

-DefaultProfile

-Destination

-Disabled

-ExcludePrefix

-Format

-IncludeBlobVersion

-IncludeDeleted

-IncludeSnapshot

-Name

-PrefixMatch

-Schedule

Dane wejściowe

Dane wyjściowe

Dodatkowe zasoby