Поделиться через


New-AzStorageBlobInventoryPolicyRule

Создает объект правила политики инвентаризации BLOB-объектов, который можно использовать в Set-AzStorageBlobInventoryPolicy.

Синтаксис

BlobRuleParameterSet (по умолчанию)

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

Описание

Командлет New-AzStorageBlobInventoryPolicyRule создает объект правила политики инвентаризации BLOB-объектов, который можно использовать в Set-AzStorageBlobInventoryPolicy.

Примеры

Пример 1. Создание объектов правил политики инвентаризации BLOB-объектов, а затем задает политику инвентаризации BLOB-объектов с объектами правила.

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

Первые 3 команды создают 3 объекта правила BlobInventoryPolicy: правило Test1 для инвентаризации контейнеров; правило Test2 для инвентаризации BLOB-объектов; правило Test3 для инвентаризации BLOB-объектов с большим числом полей схемы, исключениеPrefix, указанное и includeDeleted. Следующая команда задает политику инвентаризации BLOB-объектов в учетную запись хранения с объектами правил 3, а затем отображают обновленные свойства политики и правил.

Параметры

-BlobSchemaField

Указывает поля и свойства объекта BLOB-объектов, которые необходимо включить в инвентаризацию. Допустимые значения: Name, Creation-Time, Last-Modified, Content-Length, Content-MD5, BlobType, AccessTierChangeTime, AccessTierChangeTime, Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl, Metadata, LastAccessTime, AccessTierInferred, Tags. Имя — это обязательное поле схемы. Значения полей схемы "Истекший срок действия, hdi_isfolder, владелец, группа, разрешения, acl" допустимы только для учетных записей с включенными иерархическими именами."Теги" допустимы только для учетных записей Иерархического пространства имен. Если указать "-IncludeSnapshot", в инвентаризацию будет включено "Моментальный снимок". Если указать значение "-IncludeBlobVersion", в инвентаризацию будет включено значение VersionId, IsCurrentVersion.

Свойства параметра

Тип:

String[]

Default value:None
Допустимые значения: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
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

BlobRuleParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-BlobType

Задает типы BLOB-объектов для правила политики инвентаризации BLOB-объектов. Допустимые значения включают blockBlob, appendBlob, pageBlob. Учетные записи Hns не поддерживают страничные BLOB-объекты.

Свойства параметра

Тип:

String[]

Default value:None
Допустимые значения:blockBlob, pageBlob, appendBlob
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

BlobRuleParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ContainerSchemaField

Указывает поля и свойства объекта контейнера, которые необходимо включить в инвентаризацию. Допустимые значения: Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold. Имя — это обязательное поле схемы.

Свойства параметра

Тип:

String[]

Default value:None
Допустимые значения:Name, Last-Modified, Metadata, LeaseStatus, LeaseState, LeaseDuration, PublicAccess, HasImmutabilityPolicy, HasLegalHold, Etag, DefaultEncryptionScope, DenyEncryptionScopeOverride, ImmutableStorageWithVersioningEnabled, Deleted, Version, DeletedTime, RemainingRetentionDays
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ContainerRuleParameterSet
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CreationTimeLastNDay

Отфильтруйте объекты, которые имеют время создания за последние N дней. Допустимое значение составляет от 1 до 36500. Схема инвентаризации "Время создания" является обязательной для этого фильтра.

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

BlobRuleParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Destination

Имя контейнера, в котором хранятся файлы инвентаризации BLOB-объектов. Необходимо предварительно создать.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Disabled

Если задать это правило, правило отключено.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ExcludePrefix

Задает массив строк с префиксами большого двоичного объекта не более 10, которые будут исключены из инвентаризации.

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Format

Задает формат для файлов инвентаризации. Возможные значения: Csv, Parquet

Свойства параметра

Тип:String
Default value:None
Допустимые значения:Csv, Parquet
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IncludeBlobVersion

Если задать это правило, правило отключено.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

BlobRuleParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IncludeDeleted

Включает удаленный большой двоичный объект в инвентаризации BLOB-объектов. Если включить удаление большого двоичного объекта для ContainerSchemaFields, необходимо включить "Deleted, Version, DeletedTime и RemainingRetentionDays". Для blobSchemaFields в учетных записях хранения с поддержкой HNS необходимо включить "DeleteId, Deleted, DeletedTime и RemainingRetentionDays", а в учетных записях HNS отключенных учетных записей должны содержаться "Deleted and RemainingRetentionDays", а также исключить их.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

BlobRuleParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IncludeSnapshot

Если задать это правило, правило отключено.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

BlobRuleParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Имя правила может содержать любое сочетание буквенно-числовых символов. Имя правила чувствительно к регистру. Имя должно быть уникальным в пределах политики.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PrefixMatch

Задает массив строк для сопоставления префиксов BLOB-объектов.

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Schedule

Это поле используется для планирования формирования инвентаризации. Возможные значения: Daily, Weekly

Свойства параметра

Тип:String
Default value:None
Допустимые значения:Daily, Weekly
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

None

Выходные данные

PSBlobInventoryPolicyRule