Delen via


New-AzStorageBlobInventoryPolicyRule

Hiermee maakt u een blob-inventarisbeleidsregelobject, dat kan worden gebruikt in Set-AzStorageBlobInventoryPolicy.

Syntaxis

BlobRuleParameterSet (Standaard)

New-AzStorageBlobInventoryPolicyRule
    [-Name] <String>
    -Destination <String>
    -Format <String>
    -Schedule <String>
    -BlobSchemaField <String[]>
    -BlobType <String[]>
    [-Disabled]
    [-PrefixMatch <String[]>]
    [-ExcludePrefix <String[]>]
    [-IncludeSnapshot]
    [-IncludeBlobVersion]
    [-IncludeDeleted]
    [-CreationTimeLastNDay <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ContainerRuleParameterSet

New-AzStorageBlobInventoryPolicyRule
    [-Name] <String>
    -Destination <String>
    -Format <String>
    -Schedule <String>
    -ContainerSchemaField <String[]>
    [-Disabled]
    [-PrefixMatch <String[]>]
    [-ExcludePrefix <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

De cmdlet New-AzStorageBlobInventoryPolicyRule maakt een blob-inventarisbeleidsregelobject, dat kan worden gebruikt in Set-AzStorageBlobInventoryPolicy.

Voorbeelden

Voorbeeld 1: Beleidsregels voor blob-inventaris maken en vervolgens blob-inventarisbeleid instellen met de regelobjecten.

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

Met deze eerste drie opdrachten maakt u 3 BlobInventoryPolicy-regelobjecten: regel 'Test1' voor containerinventaris; regel "Test2" voor blob-inventaris; regel 'Test3' voor blob-inventaris met meer schemavelden, excludePrefix opgegeven en IncludeDeleted ingeschakeld. Met de volgende opdracht stelt u het blob-inventarisbeleid in op een opslagaccount met de drie regelobjecten en geeft u vervolgens de bijgewerkte eigenschappen van beleid en regels weer.

Parameters

-BlobSchemaField

Hiermee geeft u de velden en eigenschappen van het Blob-object moet worden opgenomen in de inventaris. Geldige waarden zijn: Naam, Aanmaaktijd, Laatst gewijzigd, Content-Length, Content-MD5, BlobType, AccessTier, AccessTierChangeTime, Verlooptijd, hdi_isfolder, Eigenaar, Groep, Machtigingen, Acl, Metagegevens, LastAccessTime, AccessTierInferred, Tags. 'Naam' is een vereist schemaveld. Schemaveldwaarden 'Verlooptijd, hdi_isfolder, Eigenaar, Groep, Machtigingen, Acl' zijn alleen geldig voor accounts met HierarchicalNamespace ingeschakeld.'Tags' is alleen geldig voor niet-HierarchicalNamespace-accounts. Als u '-IncludeSnapshot' opgeeft, wordt 'Momentopname' in de inventaris opgenomen. Als u '-IncludeBlobVersion' opgeeft, wordt 'VersionId, 'IsCurrentVersion' in de inventaris opgenomen.

Parametereigenschappen

Type:

String[]

Default value:None
Geaccepteerde waarden: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
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobRuleParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-BlobType

Hiermee stelt u de blobtypen voor de beleidsregel voor blob-inventaris in. Geldige waarden zijn blockBlob, appendBlob, pageBlob. Hns-accounts bieden geen ondersteuning voor pageBlobs.

Parametereigenschappen

Type:

String[]

Default value:None
Geaccepteerde waarden:blockBlob, pageBlob, appendBlob
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobRuleParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ContainerSchemaField

Hiermee geeft u de velden en eigenschappen van het containerobject moet worden opgenomen in de inventaris. Geldige waarden zijn: Naam, Laatst gewijzigd, Metagegevens, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold. 'Naam' is een vereist schemaveld.

Parametereigenschappen

Type:

String[]

Default value:None
Geaccepteerde waarden:Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ContainerRuleParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-CreationTimeLastNDay

Filter de objecten met de aanmaaktijd in de afgelopen N dagen. De geldige waarde ligt tussen 1 en 36500. Inventarisschema 'Aanmaaktijd' is verplicht met dit filter.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobRuleParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Destination

De containernaam waarin blob-inventarisbestanden worden opgeslagen. Moet vooraf worden gemaakt.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Disabled

De regel is uitgeschakeld als deze is ingesteld.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ExcludePrefix

Hiermee stelt u een matrix van tekenreeksen met maximaal 10 blobvoorvoegsels in die moeten worden uitgesloten van de inventaris.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Format

Hiermee geeft u de indeling voor de inventarisbestanden. Mogelijke waarden zijn: 'CSV', 'Parquet'

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Csv, Parquet
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IncludeBlobVersion

De regel is uitgeschakeld als deze is ingesteld.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobRuleParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IncludeDeleted

Bevat verwijderde blob in blob-inventaris. Wanneer u blob voor verwijderen opneemt, moet voor ContainerSchemaFields 'Deleted, Version, DeletedTime en RemainingRetentionDays' zijn opgenomen. Voor BlobSchemaFields moeten op HNS-opslagaccounts 'DeletionId, DeletedTime, DeletedTime en RemainingRetentionDays' zijn opgenomen en moeten voor Hns uitgeschakelde accounts 'Deleted and RemainingRetentionDays' bevatten, anders moeten ze worden uitgesloten.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobRuleParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IncludeSnapshot

De regel is uitgeschakeld als deze is ingesteld.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobRuleParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

Een regelnaam kan elke combinatie van alfanumerieke tekens bevatten. Regelnaam is hoofdlettergevoelig. Deze moet uniek zijn binnen een beleid.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PrefixMatch

Hiermee stelt u een matrix van tekenreeksen in voor blob-voorvoegsels die moeten worden vergeleken.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Schedule

Dit veld wordt gebruikt om een inventarisvorming te plannen. Mogelijke waarden zijn: 'Dagelijks', 'Wekelijks'

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Daily, Weekly
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

None

Uitvoerwaarden

PSBlobInventoryPolicyRule