Set-AzStorageBlobInventoryPolicy

參考

模組:: Az.Storage

在儲存體帳戶中建立或更新 Blob 清查原則。

Syntax

Set-AzStorageBlobInventoryPolicy
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   -Rule <PSBlobInventoryPolicyRule[]>
   [-Disabled]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzStorageBlobInventoryPolicy
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   -Policy <PSBlobInventoryPolicy>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzStorageBlobInventoryPolicy
   -StorageAccount <PSStorageAccount>
   -Rule <PSBlobInventoryPolicyRule[]>
   [-Disabled]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzStorageBlobInventoryPolicy
   -StorageAccount <PSStorageAccount>
   -Policy <PSBlobInventoryPolicy>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzStorageBlobInventoryPolicy
   [-StorageAccountResourceId] <String>
   -Rule <PSBlobInventoryPolicyRule[]>
   [-Disabled]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzStorageBlobInventoryPolicy
   [-StorageAccountResourceId] <String>
   -Policy <PSBlobInventoryPolicy>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-Az 儲存體 BlobInventoryPolicy Cmdlet 會在儲存體帳戶中建立或更新 Blob 清查原則。

範例

範例 1：使用 BlobInventoryPolicy 規則物件建立或更新 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 -IncludeBlobVersion -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

$rule3 = New-AzStorageBlobInventoryPolicyRule -Name Test3 -Destination $containerName -Format Parquet -Schedule Weekly -IncludeBlobVersion -IncludeSnapshot -IncludeDeleted -BlobType blockBlob,appendBlob -PrefixMatch aaa,bbb `
                -ExcludePrefix ccc,ddd -BlobSchemaField name,Last-Modified,BlobType,AccessTier,AccessTierChangeTime,Content-Type,Content-CRC64,CopyId,x-ms-blob-sequence-number,TagCount

$policy = Set-AzStorageBlobInventoryPolicy -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -Disabled -Rule $rule1,$rule2,$rule3

$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                                           
----  ------- -----------   ---------- ------  -------- ---------------- ------------------- -------------- ---------               ----------- -------------  ------------                                           
Test1 False   containername Container  Csv     Daily                                                                                {con1, con2}               {Name, Metadata, PublicAccess, Last-Modified...}       
Test2 True    containername Blob       Parquet Weekly   True             True                               {blockBlob, appendBlob} {aaa, bbb}                 {Name, Creation-Time, Last-Modified, Content-Length...}
Test3 True    containername Blob       Parquet Weekly   True             True                True           {blockBlob, appendBlob} {aaa, bbb}  {ccc, ddd}     {Name, Content-Type, Content-CRC64, Last-Modified...}

前 2 個命令會建立 3 個 BlobInventoryPolicy 規則對象：規則 “Test1” for contaienr inventory;Blob 清查的規則「Test2」和「Test3」。下列命令會將 Blob 清查原則設定為具有 2 個規則物件的儲存體帳戶，然後顯示更新的原則和規則屬性。

範例 2：使用 Json 格式原則建立或更新儲存體帳戶的 Blob 清查原則。

$policy = Set-AzStorageBlobInventoryPolicy -ResourceGroupName $resourceGroupName  -StorageAccountName $accountName -Policy (@{
                Enabled=$true;
                Rules=(@{
                    Enabled=$true;
                    Name="Test1";
                    Destination=$containerName;
                    Definition=(@{
                        ObjectType="Blob";
                        Format="Csv";
                        Schedule="Weekly";
                        SchemaFields=@("name","Content-Length","BlobType","Snapshot","VersionId","IsCurrentVersion");
                        Filters=(@{
                            BlobTypes=@("blockBlob","appendBlob");
                            PrefixMatch=@("prefix1","prefix2");
                            IncludeSnapshots=$true;
                            IncludeBlobVersions=$true;
                        })
                    })
                },
                @{
                    Enabled=$false;
                    Name="Test2";
                    Destination=$containerName;
                    Definition=(@{
                        ObjectType="Container";
                        Format="Parquet";
                        Schedule="Daily";
                        SchemaFields=@("name","Metadata","PublicAccess","DefaultEncryptionScope","DenyEncryptionScopeOverride");
                        Filters=(@{
                            PrefixMatch=@("conpre1","conpre2");
                        })
                    })
                },
                @{
                    Enabled=$false;
                    Name="Test3";
                    Destination=$containerName;
                    Definition=(@{
                        ObjectType="Blob";
                        Format="Csv";
                        Schedule="Weekly";
                        SchemaFields=@("name","Deleted","RemainingRetentionDays","Content-Type","Content-Language","Cache-Control","Content-Disposition");
                        Filters=(@{
                            BlobTypes=@("blockBlob","appendBlob");
                            PrefixMatch=@("conpre1","conpre2");
                            ExcludePrefix=@("expre1","expre2");
                            IncludeDeleted=$true
                        })
                    })
                })
            })


$policy

StorageAccountName : weiadlscanary1
ResourceGroupName  : weitry
Name               : DefaultInventoryPolicy
Id                 : /subscriptions/{subscription-Id}/resourceGroups/weitry/providers/Microsoft.Storage/storageAccounts/weiadlscanary1/inventoryPolicies/default
Type               : Microsoft.Storage/storageAccounts/inventoryPolicies
LastModifiedTime   : 5/12/2021 9:02:21 AM
Enabled            : True
Rules              : {Test1, Test2, Test3}

$policy.Rules 

Name  Enabled Destination   ObjectType Format  Schedule IncludeSnapshots IncludeBlobVersions IncludeDeleted BlobTypes               PrefixMatch        ExcludePrefix    SchemaFields                                           
----  ------- -----------   ---------- ------  -------- ---------------- ------------------- -------------- ---------               -----------        -------------    ------------                                           
Test1 True    containername Blob       Csv     Weekly   True             True                               {blockBlob, appendBlob} {prefix1, prefix2}                  {Name, Content-Length, BlobType, Snapshot...}     
Test2 False   containername Container  Parquet Daily                                                                                {conpre1, conpre2}                  {Name, Metadata, PublicAccess} 
Test3 False   containername Blob       Csv     Weekly                                        True           {blockBlob, appendBlob} {conpre1, conpre2} {expre1, expre2} {Name, Content-Type, Content-Cache, Content-Language...}                                                                                    {name, Metadata, PublicAccess}

此命令會使用 json 格式原則，建立或更新儲存體帳戶的 Blob 清查原則。

範例 3：從儲存體帳戶取得 Blob 清查原則，然後將它設定為另一個儲存體帳戶。

$policy = Get-AzStorageBlobInventoryPolicy -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" | Set-AzStorageBlobInventoryPolicy -ResourceGroupName "myresourcegroup2" -AccountName "mystorageaccount2"

此命令會先從儲存體帳戶取得 Blob 清查原則，然後將它設定為另一個儲存體帳戶。 Proeprties：目的地、啟用和原則規則將會設定為目的地帳戶。

範例 4：從儲存體帳戶取得 Blob 清查原則規則，然後將它設定為另一個儲存體帳戶。

$policy = ,((Get-AzStorageBlobInventoryPolicy -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount").Rules) | Set-AzStorageBlobInventoryPolicy -ResourceGroupName "myresourcegroup2" -AccountName "mystorageaccount2" -Disabled

此命令會先從儲存體帳戶取得 Blob 清查原則，然後將它的規則設定為另一個儲存體帳戶。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

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

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

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

-Disabled

Blob 清查原則預設為啟用，請指定此參數來停用它。

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

-Policy

要設定的 Blob 清查原則物件

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

-ResourceGroupName

資源群組名稱。

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

-Rule

Blob 清查原則規則。使用 New-Az 儲存體 BlobInventoryPolicyRule Cmdlet 取得物件。

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

-StorageAccount

儲存體帳戶物件

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

-StorageAccountName

儲存體帳戶名稱。

Type:	String
Aliases:	AccountName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageAccountResourceId

儲存體帳戶資源標識碼。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

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

輸入

PSStorageAccount

String

PSBlobInventoryPolicyRule[]

Microsoft.Azure.Commands.Management.Storage.Models.PSBlobInventoryPolicySchema

輸出

PSManagementPolicy

Set-AzStorageBlobInventoryPolicy

Syntax

Description

範例

範例 1：使用 BlobInventoryPolicy 規則物件建立或更新 Blob 清查原則。

範例 2：使用 Json 格式原則建立或更新儲存體帳戶的 Blob 清查原則。

範例 3：從儲存體帳戶取得 Blob 清查原則，然後將它設定為另一個儲存體帳戶。

範例 4：從儲存體帳戶取得 Blob 清查原則規則，然後將它設定為另一個儲存體帳戶。

參數

-Confirm

-DefaultProfile

-Disabled

-Policy

-ResourceGroupName

-Rule

-StorageAccount

-StorageAccountName

-StorageAccountResourceId

-WhatIf

輸入

輸出

意見反應

其他資源

Set-AzStorageBlobInventoryPolicy

Syntax

Description

範例

範例 1：使用 BlobInventoryPolicy 規則物件建立或更新 Blob 清查原則。

範例 2：使用 Json 格式原則建立或更新 儲存體 帳戶的 Blob 清查原則。

範例 3：從 儲存體 帳戶取得 Blob 清查原則，然後將它設定為另一個 儲存體 帳戶。

範例 4：從 儲存體 帳戶取得 Blob 清查原則規則，然後將它設定為另一個 儲存體 帳戶。

參數

-Confirm

-DefaultProfile

-Disabled

-Policy

-ResourceGroupName

-Rule

-StorageAccount

-StorageAccountName

-StorageAccountResourceId

-WhatIf

輸入

輸出

意見反應

其他資源

範例 2：使用 Json 格式原則建立或更新儲存體帳戶的 Blob 清查原則。

範例 3：從儲存體帳戶取得 Blob 清查原則，然後將它設定為另一個儲存體帳戶。

範例 4：從儲存體帳戶取得 Blob 清查原則規則，然後將它設定為另一個儲存體帳戶。