New-AzStorageBlobInventoryPolicyRule
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ły 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".
| Type: | String[] |
| Accepted values: | 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 |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Accepted values: | blockBlob, pageBlob, appendBlob |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Accepted values: | Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Destination
Nazwa kontenera, w którym są przechowywane pliki spisu obiektów blob. Należy wstępnie utworzyć.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Disabled
Reguła jest wyłączona, jeśli ją ustawisz.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcludePrefix
Ustawia tablicę ciągów z maksymalnie 10 prefiksami obiektów blob do wykluczenia ze spisu.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Format
Określa format plików spisu. Możliwe wartości to: "Csv", "Parquet"
| Type: | String |
| Accepted values: | Csv, Parquet |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeBlobVersion
Reguła jest wyłączona, jeśli ją ustawisz.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeSnapshot
Reguła jest wyłączona, jeśli ją ustawisz.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrefixMatch
Ustawia tablicę ciągów dla prefiksów obiektów blob, które mają być dopasowane.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Schedule
To pole służy do planowania tworzenia spisu. Możliwe wartości to: "Codziennie", "Co tydzień"
| Type: | String |
| Accepted values: | Daily, Weekly |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Dane wejściowe
None
Dane wyjściowe
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla