Compartir a través de

Set-AzureStorageBlobContent

  • Referencia
Módulo:
Azure.Storage

Carga un archivo local en un blob de Azure Storage.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

Set-AzureStorageBlobContent
   [-File] <String>
   [-Container] <String>
   [-Blob <String>]
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   [-Blob <String>]
   -CloudBlobContainer <CloudBlobContainer>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   -CloudBlob <CloudBlob>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzureStorageBlobContent carga un archivo local en un blob de Azure Storage.

Ejemplos

Ejemplo 1: Carga de un archivo con nombre

PS C:\>Set-AzureStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"

Este comando carga el archivo denominado PlanningData en un blob denominado Planning2015.

Ejemplo 2: Carga de todos los archivos en la carpeta actual

PS C:\>Get-ChildItem -File -Recurse | Set-AzureStorageBlobContent -Container "ContosoUploads"

Este comando usa el cmdlet principal de Windows PowerShell Get-ChildItem para obtener todos los archivos de la carpeta actual y en las subcarpetas y, a continuación, los pasa al cmdlet actual mediante el operador de canalización. El cmdlet Set-AzureStorageBlobContent carga los archivos en el contenedor denominado ContosoUploads.

Ejemplo 3: Sobrescribir un blob existente

PS C:\>Get-AzureStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzureStorageBlobContent -File "ContosoPlanning"

Este comando obtiene el blob denominado Planning2015 en el contenedor ContosoUploads mediante el cmdlet Get-AzureStorageBlob y, a continuación, pasa ese blob al cmdlet actual. El comando carga el archivo denominado ContosoPlanning como Planning2015. Este comando no especifica el parámetro Force . El comando le pide confirmación. Si confirma el comando, el cmdlet sobrescribe el blob existente.

Ejemplo 4: Carga de un archivo en un contenedor mediante la canalización

PS C:\>Get-AzureStorageContainer -Container "ContosoUpload*" | Set-AzureStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"

Este comando obtiene el contenedor que comienza con la cadena ContosoUpload mediante el cmdlet Get-AzureStorageContainer y, a continuación, pasa ese blob al cmdlet actual. El comando carga el archivo denominado ContosoPlanning como Planning2015.

Ejemplo 5: Carga de un archivo en blob en páginas con metadatos y PremiumPageBlobTier como P10

PS C:\>$Metadata = @{"key" = "value"; "name" = "test"}
PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10

El primer comando crea una tabla hash que contiene metadatos para un blob y almacena esa tabla hash en la variable $Metadata. El segundo comando carga el archivo denominado ContosoPlanning en el contenedor denominado ContosoUploads. El blob incluye los metadatos almacenados en $Metadata y tiene PremiumPageBlobTier como P10.

Ejemplo 6: Carga de un archivo en un blob con propiedades de blob especificadas

PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Properties @{"ContentType" = "image/jpeg"; "ContentMD5" = "i727sP7HigloQDsqadNLHw=="}

Este comando carga el archivo denominado ContosoPlanning en el contenedor denominado ContosoUploads con las propiedades de blob especificadas.

Parámetros

-Blob

Especifica el nombre de un blob. Este cmdlet carga un archivo en el blob de Azure Storage que especifica este parámetro.

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

-BlobType

Especifica el tipo del blob que carga este cmdlet. Los valores permitidos para este parámetro son los siguientes:

  • Bloquear
  • Página El valor predeterminado es Bloquear.
Tipo:String
Valores aceptados:Block, Page, Append
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
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]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CloudBlob

Especifica un objeto CloudBlob . Para obtener un objeto CloudBlob , use el cmdlet Get-AzureStorageBlob.

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. Este cmdlet carga contenido en un blob del contenedor que especifica este parámetro. Para obtener un objeto CloudBlobContainer , use el cmdlet Get-AzureStorageContainer.

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 de un contenedor. Este cmdlet carga un archivo en un blob del contenedor que especifica este parámetro.

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

-Context

Especifica un contexto de almacenamiento de Azure. Para obtener un contexto de almacenamiento, use el cmdlet New-AzureStorageContext. Para usar un contexto de almacenamiento creado a partir de un token de SAS sin permiso de lectura, necesita agregar el parámetro -Force para omitir la comprobación de la existencia del blob.

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

-File

Especifica una ruta de acceso de archivo local para que un archivo se cargue como contenido de blobs.

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

-Force

Indica que este cmdlet sobrescribe un blob existente sin pedir confirmación.

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

-Metadata

Especifica los metadatos del blob cargado.

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

-PremiumPageBlobTier

Nivel de blob en páginas

Tipo:PremiumPageBlobTier
Valores aceptados:Unknown, P4, P6, P10, P20, P30, P40, P50, P60
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Properties

Especifica las propiedades del blob cargado. Las propiedades admitidas son: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.

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

-ServerTimeoutPerRequest

Especifica el intervalo de tiempo de espera del lado del servicio, en segundos, para una solicitud. Si el intervalo especificado transcurre antes de que el servicio procese la solicitud, el servicio de almacenamiento devuelve un error.

Tipo:Nullable<T>[Int32]
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

String

CloudBlobContainer

CloudBlob

IStorageContext

Salidas

AzureStorageBlob