Remove-AzStorageBlob

  • 參考
模組:
Az.Storage

拿掉指定的記憶體 Blob。

Syntax

Remove-AzStorageBlob
      [-Blob] <String>
      [-Container] <String>
      [-DeleteSnapshot]
      [-SnapshotTime <DateTimeOffset>]
      [-VersionId <String>]
      [-Force]
      [-PassThru]
      [-TagCondition <String>]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzStorageBlob
      -CloudBlob <CloudBlob>
      [-BlobBaseClient <BlobBaseClient>]
      [-DeleteSnapshot]
      [-Force]
      [-PassThru]
      [-TagCondition <String>]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzStorageBlob
      -CloudBlobContainer <CloudBlobContainer>
      [-Blob] <String>
      [-DeleteSnapshot]
      [-SnapshotTime <DateTimeOffset>]
      [-VersionId <String>]
      [-Force]
      [-PassThru]
      [-TagCondition <String>]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Remove-Az 儲存體 Blob Cmdlet 會從 Azure 中的記憶體帳戶中移除指定的 Blob。

範例

範例 1：依名稱移除記憶體 Blob

Remove-AzStorageBlob -Container "ContainerName" -Blob "BlobName"

此命令會移除其名稱所識別的 Blob。

範例 2：使用管線移除記憶體 Blob

Get-AzStorageBlob -Container "ContainerName" -Blob "BlobName" | Remove-AzStorageBlob

此命令會使用管線。

範例 3：使用管線移除記憶體 Blob

Get-AzStorageContainer -Container container* | Remove-AzStorageBlob -Blob "BlobName"

此命令會使用星號 \ 通配符和管線來擷取 Blob 或 Blob，然後移除它們。

範例 4：移除單一 Blob 版本

Remove-AzStorageBlob -Container "containername" -Blob blob2 -VersionId "2020-07-03T16:19:16.2883167Z"

此命令會移除具有 VersionId 的單一 Blob 頂點。

範例 5：移除單一 Blob 快照集

Remove-AzStorageBlob -Container "containername" -Blob blob1 -SnapshotTime "2020-07-06T06:56:06.8588431Z"

此命令會移除具有 SnapshotTime 的單一 Blob 快照集。

參數

-Blob

指定您要移除的 Blob 名稱。

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

-BlobBaseClient

BlobBaseClient 物件

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

-ClientTimeoutPerRequest

指定一個服務要求的用戶端超時時間間隔，以秒為單位。 如果先前的呼叫在指定的間隔內失敗，此 Cmdlet 會重試要求。 如果此 Cmdlet 在間隔經過之前未收到成功的回應，此 Cmdlet 會傳回錯誤。

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CloudBlob

指定雲端 Blob。 若要取得 CloudBlob 物件，請使用 Get-Az 儲存體 Blob Cmdlet。

Type:CloudBlob
Aliases:ICloudBlob
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CloudBlobContainer

從 Azure 儲存體 客戶端連結庫指定 CloudBlobContainer 物件。 您可以使用 Get-Az 儲存體 Container Cmdlet 來取得它。

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

-ConcurrentTaskCount

指定並行網路呼叫上限。 您可以藉由指定並行網路呼叫數目上限，使用此參數來限制並行 CPU 和頻寬使用量的並行存取。 指定的值是絕對計數，不會乘以核心計數。 此參數可協助減少低頻寬環境中的網路連線問題，例如每秒 100 千位。 預設值為 10。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

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

-Container

指定容器的名稱。

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

-Context

指定 Azure 記憶體內容。 您可以使用 New-Az 儲存體 Context Cmdlet 來建立它。

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

-DefaultProfile

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

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

-DeleteSnapshot

指定刪除所有快照集，但不要刪除基底 Blob。 如果未指定此參數，基底 Blob 及其快照集會一起刪除。 系統會提示使用者確認刪除作業。

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

-Force

指出此 Cmdlet 會移除 Blob 及其快照集，而不需確認。

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

-PassThru

指出此 Cmdlet 會傳回 Boolean ，反映作業的成功。 根據預設，此 Cmdlet 不會傳回值。

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

-ServerTimeoutPerRequest

指定要讀取之 Cmdlet 的 Azure 設定檔。 如果未指定，Cmdlet 會從預設配置檔讀取。

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SnapshotTime

Blob SnapshotTime

Type:Nullable<T>[DateTimeOffset]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TagCondition

要檢查比對條件的選擇性標記表達式語句。 Blob 標籤不符合指定表示式時，Blob 要求將會失敗。 請參閱 https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations 中的詳細資料。

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

-VersionId

Blob VersionId

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

-WhatIf

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

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

輸入

CloudBlob

CloudBlobContainer

IStorageContext

輸出

Boolean