Remove-AzStorageBlob
Odebere zadaný objekt blob úložiště.
Syntaxe
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.
Typ: | String |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-BlobBaseClient
Objekt BlobBaseClient
Typ: | BlobBaseClient |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | 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.
Typ: | Nullable<T>[Int32] |
Aliasy: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-CloudBlob
Určuje cloudový objekt blob. K získání objektu CloudBlob použijte rutinu Get-AzStorageBlob.
Typ: | CloudBlob |
Aliasy: | ICloudBlob |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-CloudBlobContainer
Určuje objekt CloudBlobContainer z klientské knihovny služby Azure Storage. K získání můžete použít rutinu Get-AzStorageContainer.
Typ: | CloudBlobContainer |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | 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.
Typ: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Container
Určuje název kontejneru.
Typ: | String |
Position: | 1 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Context
Určuje kontext úložiště Azure. K jeho vytvoření můžete použít rutinu New-AzStorageContext.
Typ: | IStorageContext |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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í.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Force
Označuje, že tato rutina odebere objekt blob a jeho snímek bez potvrzení.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ServerTimeoutPerRequest
Určuje profil Azure, který má rutina číst. Pokud není zadaný, rutina načte z výchozího profilu.
Typ: | Nullable<T>[Int32] |
Aliasy: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-SnapshotTime
Blob SnapshotTime
Typ: | Nullable<T>[DateTimeOffset] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-VersionId
Id verze objektu blob
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
Výstupy
Související odkazy
Azure PowerShell