Freigeben über


Remove-AzStorageBlob

Entfernt das angegebene Speicher-BLOB.

Syntax

NamePipeline (Standard)

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

BlobPipeline

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

ContainerPipeline

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

Beschreibung

Das Cmdlet Remove-AzStorageBlob entfernt das angegebene Blob aus einem Speicherkonto in Azure.

Beispiele

Beispiel 1: Entfernen eines Speicher-BLOB anhand des Namens

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

Mit diesem Befehl wird ein BLOB entfernt, das durch seinen Namen identifiziert wird.

Beispiel 2: Entfernen eines Speicher-Blobs mithilfe der Pipeline

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

Dieser Befehl verwendet die Pipeline.

Beispiel 3: Entfernen von Speicher-Blobs mithilfe der Pipeline

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

Dieser Befehl verwendet das Sternchen (*) Platzhalterzeichen und die Pipeline, um die Blobs oder Blobs abzurufen und dann zu entfernen.

Beispiel 4: Entfernen einer einzelnen BLOB-Version

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

Mit diesem Befehl wird eine einzelne Blobs-Version mit VersionId entfernt.

Beispiel 5: Entfernen einer einzelnen BLOB-Momentaufnahme

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

Mit diesem Befehl wird eine einzelne Blobs-Momentaufnahme mit SnapshotTime entfernt.

Parameter

-Blob

Gibt den Namen des BLOB an, das Sie entfernen möchten.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NamePipeline
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ContainerPipeline
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-BlobBaseClient

BlobBaseClient-Objekt

Parametereigenschaften

Typ:BlobBaseClient
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

BlobPipeline
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ClientTimeoutPerRequest

Gibt das clientseitige Timeoutintervall in Sekunden für eine Serviceanfrage an. Wenn der vorherige Aufruf im angegebenen Intervall fehlschlägt, führt dieses Cmdlet die Anforderung erneut aus. Wenn dieses Cmdlet vor Ablauf des Intervalls keine erfolgreiche Antwort erhält, gibt dieses Cmdlet einen Fehler zurück.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ClientTimeoutPerRequestInSeconds

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CloudBlob

Gibt ein Cloud-Blob an. Verwenden Sie das Cmdlet Get-AzStorageBlob, um ein CloudBlob-Objekt abzurufen.

Parametereigenschaften

Typ:Microsoft.Azure.Storage.Blob.CloudBlob
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ICloudBlob

Parametersätze

BlobPipeline
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-CloudBlobContainer

Gibt ein CloudBlobContainer - Objekt aus der Azure Storage-Clientbibliothek an. Sie können das cmdlet Get-AzStorageContainer verwenden, um es abzurufen.

Parametereigenschaften

Typ:Microsoft.Azure.Storage.Blob.CloudBlobContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ContainerPipeline
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ConcurrentTaskCount

Gibt die maximalen gleichzeitigen Netzwerkanrufe an. Mit diesem Parameter können Sie die Parallelität einschränken, um die lokale CPU- und Bandbreitenauslastung zu drosseln, indem Sie die maximale Anzahl gleichzeitiger Netzwerkanrufe angeben. Der angegebene Wert ist eine absolute Anzahl und wird nicht mit der Kernanzahl multipliziert. Dieser Parameter kann dazu beitragen, Netzwerkverbindungsprobleme in Umgebungen mit geringer Bandbreite zu reduzieren, z. B. 100 Kilobit pro Sekunde. Der Standardwert ist 10.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Container

Gibt den Namen des Containers an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NamePipeline
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Context

Gibt den Azure-Speicherkontext an. Sie können das cmdlet New-AzStorageContext verwenden, um es zu erstellen.

Parametereigenschaften

Typ:IStorageContext
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DeleteSnapshot

Gibt an, dass alle Momentaufnahmen gelöscht werden, aber nicht das Basis-BLOB. Wenn dieser Parameter nicht angegeben ist, werden das Basis-BLOB und die zugehörigen Momentaufnahmen zusammen gelöscht. Der Benutzer wird aufgefordert, den Löschvorgang zu bestätigen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

Gibt an, dass dieses Cmdlet das Blob und dessen Momentaufnahme ohne Bestätigung entfernt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PassThru

Gibt an, dass dieses Cmdlet einen Wert vom Typ Boolean zurückgibt, der den Erfolg des Vorgangs widerspiegelt. Standardmäßig gibt dieses Cmdlet keinen Wert zurück.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ServerTimeoutPerRequest

Gibt das Azure-Profil für das zu lesende Cmdlet an. Wenn nicht angegeben, liest das Cmdlet aus dem Standardprofil.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ServerTimeoutPerRequestInSeconds

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SnapshotTime

Blob SnapshotTime

Parametereigenschaften

Typ:

Nullable<T>[DateTimeOffset]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NamePipeline
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ContainerPipeline
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TagCondition

Optionale Tag-Ausdrucksanweisung zum Überprüfen der Übereinstimmungsbedingung. Die BLOB-Anforderung schlägt fehl, wenn die Blobtags nicht mit dem angegebenen Ausdruck übereinstimmen. Weitere Informationen finden Sie unter https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VersionId

Blob-VersionId

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NamePipeline
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ContainerPipeline
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

Microsoft.Azure.Storage.Blob.CloudBlob

Microsoft.Azure.Storage.Blob.CloudBlobContainer

IStorageContext

Ausgaben

Boolean