Remove-AzStorageBlob

  • Reference
Modul:
Az.Storage

Odebere zadaný objekt blob úložiště.

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

Rutina Remove-AzStorageBlob odebere zadaný objekt blob z účtu úložiště v Azure.

Příklady

Příklad 1: Odebrání objektu blob úložiště podle názvu

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

Tento příkaz odebere objekt blob identifikovaný jeho názvem.

Příklad 2: Odebrání objektu blob úložiště pomocí kanálu

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

Tento příkaz používá kanál.

Příklad 3: Odebrání objektů blob úložiště pomocí kanálu

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

Tento příkaz používá zástupný znak hvězdičky (*) a kanál k načtení objektu blob nebo objektů blob a jejich odebrání.

Příklad 4: Odebrání verze jednoho objektu blob

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

Tento příkaz odebere jeden objekt blob s VersionId.

Příklad 5: Odebrání jednoho snímku objektu blob

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

Tento příkaz odebere snímek s jedním objektem blob pomocí snapshotTime.

Parametry

-Blob

Určuje název objektu blob, který chcete odebrat.

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

-BlobBaseClient

Objekt BlobBaseClient

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

-ClientTimeoutPerRequest

Určuje interval časového limitu na straně klienta v sekundách pro jednu žádost o službu. Pokud předchozí volání v zadaném intervalu selže, tato rutina požadavek opakuje. Pokud tato rutina neobdrží úspěšnou odpověď před uplynutím intervalu, vrátí tato rutina chybu.

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

-CloudBlob

Určuje cloudový objekt blob. K získání objektu CloudBlob použijte rutinu Get-AzStorageBlob.

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

-CloudBlobContainer

Určuje objekt CloudBlobContainer z klientské knihovny služby Azure Storage. K získání můžete použít rutinu Get-AzStorageContainer.

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

-ConcurrentTaskCount

Určuje maximální počet souběžných síťových volání. Pomocí tohoto parametru můžete omezit souběžnost na omezení využití místního procesoru a šířky pásma zadáním maximálního počtu souběžných síťových volání. Zadaná hodnota je absolutní počet a nevynásobí se počtem jader. Tento parametr může pomoct snížit problémy s připojením k síti v prostředích s nízkou šířkou pásma, například 100 kilobitů za sekundu. Výchozí hodnota je 10.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Container

Určuje název kontejneru.

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

-Context

Určuje kontext úložiště Azure. K jeho vytvoření můžete použít rutinu New-AzStorageContext.

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

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

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

-DeleteSnapshot

Určuje, že se odstraní všechny snímky, ale ne základní objekt blob. Pokud tento parametr není zadaný, základní objekt blob a jeho snímky se odstraní společně. Uživateli se zobrazí výzva k potvrzení operace odstranění.

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

-Force

Označuje, že tato rutina odebere objekt blob a jeho snímek bez potvrzení.

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

-PassThru

Označuje, že tato rutina vrátí logickou hodnotu , která odráží úspěch operace. Ve výchozím nastavení tato rutina nevrací hodnotu.

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

-ServerTimeoutPerRequest

Určuje profil Azure, který má rutina číst. Pokud není zadaný, rutina načte z výchozího profilu.

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

Volitelný příkaz výrazu Tag pro kontrolu podmínky shody. Požadavek na objekt blob selže, pokud značky objektů blob neodpovídají danému výrazu. Podívejte se na podrobnosti na stránce 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

Id verze objektu blob

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

CloudBlob

CloudBlobContainer

IStorageContext

Výstupy

Boolean