Compartir a través de

Remove-AzStorageBlob

  • Referencia
Módulo:
Az.Storage

Quita el blob de almacenamiento especificado.

Sintaxis

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

El cmdlet Remove-AzStorageBlob quita el blob especificado de una cuenta de almacenamiento en Azure.

Ejemplos

Ejemplo 1: Eliminación de un blob de almacenamiento por nombre

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

Este comando quita un blob identificado por su nombre.

Ejemplo 2: Eliminación de un blob de almacenamiento mediante la canalización

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

Este comando usa la canalización.

Ejemplo 3: Eliminación de blobs de almacenamiento mediante la canalización

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

Este comando usa el carácter comodín asterisco (*) y la canalización para recuperar el blob o blobs y, a continuación, los quita.

Ejemplo 4: Eliminación de una sola versión de blob

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

Este comando quita un solo verbo de blobs con VersionId.

Ejemplo 5: Eliminación de una sola instantánea de blob

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

Este comando quita una sola instantánea de blobs con SnapshotTime.

Parámetros

-Blob

Especifica el nombre del blob que desea quitar.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BlobBaseClient

BlobBaseClient (objeto)

Tipo:BlobBaseClient
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ClientTimeoutPerRequest

Especifica el intervalo de tiempo de espera del lado cliente, en segundos, para una solicitud de servicio. Si se produce un error en la llamada anterior en el intervalo especificado, este cmdlet reintenta la solicitud. Si este cmdlet no recibe una respuesta correcta antes de que transcurre el intervalo, este cmdlet devuelve un error.

Tipo:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CloudBlob

Especifica un blob en la nube. Para obtener un objeto CloudBlob , use el cmdlet Get-AzStorageBlob.

Tipo:CloudBlob
Alias:ICloudBlob
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-CloudBlobContainer

Especifica un objeto CloudBlobContainer de la biblioteca cliente de Azure Storage. Puede usar el cmdlet Get-AzStorageContainer para obtenerlo.

Tipo:CloudBlobContainer
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ConcurrentTaskCount

Especifica el número máximo de llamadas de red simultáneas. Puede usar este parámetro para limitar la simultaneidad para limitar el uso de ancho de banda y CPU local especificando el número máximo de llamadas de red simultáneas. El valor especificado es un recuento absoluto y no se multiplica por el recuento de núcleos. Este parámetro puede ayudar a reducir los problemas de conexión de red en entornos de ancho de banda bajo, como 100 kilobits por segundo. El valor predeterminado es 10.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Container

Especifica el nombre del contenedor.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Context

Especifica el contexto de almacenamiento de Azure. Puede usar el cmdlet New-AzStorageContext para crearlo.

Tipo:IStorageContext
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeleteSnapshot

Especifica que se eliminarán todas las instantáneas, pero no el blob base. Si no se especifica este parámetro, el blob base y sus instantáneas se eliminan juntas. Se solicita al usuario que confirme la operación de eliminación.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Indica que este cmdlet quita el blob y su instantánea sin confirmación.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Indica que este cmdlet devuelve un valor booleano que refleja el éxito de la operación. De forma predeterminada, este cmdlet no devuelve un valor.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServerTimeoutPerRequest

Especifica el perfil de Azure para que el cmdlet se lea. Si no se especifica, el cmdlet lee del perfil predeterminado.

Tipo:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SnapshotTime

SnapshotTime de blobs

Tipo:Nullable<T>[DateTimeOffset]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TagCondition

Instrucción de expresión tag opcional para comprobar la condición de coincidencia. Se producirá un error en la solicitud de blob cuando las etiquetas de blob no coincidan con la expresión especificada. Consulte los detalles en https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VersionId

Blob VersionId

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

CloudBlob

CloudBlobContainer

IStorageContext

Salidas

Boolean