Share via

New-AzStorageBlobInventoryPolicyRule

  • Referenz
Modul:
Az.Storage

Erstellt ein Blobinventarrichtlinienregelobjekt, das in Set-AzStorageBlobInventoryPolicy verwendet werden kann.

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

Beschreibung

Das Cmdlet New-AzStorageBlobInventoryPolicyRule erstellt ein Blob-Richtlinienregelobjekt, das in Set-AzStorageBlobInventoryPolicy verwendet werden kann.

Beispiele

Beispiel 1: Erstellen von Blobinventurrichtlinienregelobjekten und anschließendes Festlegen der Blobinventurrichtlinie mit den 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...}

Mit diesen ersten drei Befehlen werden 3 BlobInventoryPolicy-Regelobjekte erstellt: Regel "Test1" für den Contaienr-Bestand; Regel "Test2" für blob-Inventar; Regel "Test3" für blobinventar mit weiteren Schemafeldern, excludePrefix angegeben und IncludeDeleted aktiviert. Mit dem folgenden Befehl wird die Blobinventurrichtlinie auf ein Speicherkonto mit den drei Regelobjekten festgelegt, und anschließend werden die aktualisierten Richtlinien- und Regeleigenschaften angezeigt.

Parameter

-BlobSchemaField

Gibt die Felder und Eigenschaften des Blob-Objekts an, das in den Bestand aufgenommen werden soll. Gültige Werte sind: Name, Erstellungszeit, Zuletzt geändert, Inhaltslänge, Content-MD5, BlobType, AccessTier, AccessTierChangeTime, Ablaufzeit, hdi_isfolder, Besitzer, Gruppe, Berechtigungen, Acl, Metadaten, LastAccessTime, AccessTierInferred, Tags. "Name" ist ein erforderliches Schemafeld. Schemafeldwerte 'Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl' sind nur für hierarchisch aktivierte Konten gültig.'Tags' Feld ist nur für nicht hierarchischeNamespace-Konten gültig. Wenn Sie "-IncludeSnapshot" angeben, wird "Snapshot" in den Bestand eingeschlossen. Wenn "-IncludeBlobVersion" angegeben wird, wird "VersionId, 'IsCurrentVersion' im Bestand enthalten.

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

Legt die BLOB-Typen für die Blob-Bestandsrichtlinienregel fest. Gültige Werte sind "blockBlob", "appendBlob", "pageBlob". Hns-Konten unterstützen pageBlobs nicht.

Type:String[]
Accepted values:blockBlob, pageBlob, appendBlob
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ContainerSchemaField

Gibt die Felder und Eigenschaften des Containerobjekts an, das in das Inventar aufgenommen werden soll. Gültige Werte sind: Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold. "Name" ist ein erforderliches Schemafeld.

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

Filtern Sie die Objekte, die die Erstellungszeit in den letzten N Tagen haben. Der gültige Wert liegt zwischen 1 und 36500. Das Bestandsschema "Erstellungszeit" ist mit diesem Filter obligatorisch.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Destination

Der Containername, in dem Blobinventardateien gespeichert werden. Muss vorab erstellt werden.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Disabled

Die Regel ist deaktiviert, wenn sie festgelegt wird.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludePrefix

Legt ein Array von Zeichenfolgen mit maximal 10 Blobpräfixen fest, die aus dem Bestand ausgeschlossen werden sollen.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Format

Gibt das Format für die Bestandsdateien an. Mögliche Werte sind: "Csv", "Parkett"

Type:String
Accepted values:Csv, Parquet
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-IncludeBlobVersion

Die Regel ist deaktiviert, wenn sie festgelegt wird.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeDeleted

Enthält ein gelöschtes BLOB im BLOB-Bestand. Wenn "Blob löschen" für ContainerSchemaFields eingeschlossen wird, muss "Gelöscht, Version, DeletedTime und Re Standard ingRetentionDays" enthalten sein. Für BlobSchemaFields muss für HNS-aktivierte Speicherkonten "DeleteId,Deleted, DeletedTime and Re Standard ingRetentionDays" enthalten, und auf Hns deaktivierten Konten müssen "Deleted and Re Standard ingRetentionDays" enthalten sein, andernfalls müssen sie ausgeschlossen werden.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeSnapshot

Die Regel ist deaktiviert, wenn sie festgelegt wird.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Ein Regelname kann aus einer beliebigen Kombination von alphanumerischen Zeichen bestehen. Bei Regelnamen wird die Groß-/Kleinschreibung unterschieden. Er muss innerhalb einer Richtlinie eindeutig sein.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PrefixMatch

Legt ein Array von Zeichenfolgen für Blobpräfixe fest, die abgeglichen werden sollen.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Schedule

Dieses Feld wird verwendet, um eine Bestandsbildung zu planen. Mögliche Werte sind: "Täglich", "Wöchentlich"

Type:String
Accepted values:Daily, Weekly
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

PSBlobInventoryPolicyRule