Freigeben über

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.

Typ:String[]
Zulässige Werte: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
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:String[]
Zulässige Werte:blockBlob, pageBlob, appendBlob
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:String[]
Zulässige Werte:Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Destination

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Disabled

Die Regel ist deaktiviert, wenn sie festgelegt wird.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExcludePrefix

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

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Format

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

Typ:String
Zulässige Werte:Csv, Parquet
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IncludeBlobVersion

Die Regel ist deaktiviert, wenn sie festgelegt wird.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IncludeDeleted

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IncludeSnapshot

Die Regel ist deaktiviert, wenn sie festgelegt wird.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PrefixMatch

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

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Schedule

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

Typ:String
Zulässige Werte:Daily, Weekly
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

PSBlobInventoryPolicyRule