Compartir a través de


Set-AzStorageBlobContent

Carga un archivo local en un blob de Azure Storage.

Sintaxis

SendManual (valor predeterminado)

Set-AzStorageBlobContent
    [-File] <String>
    [-Container] <String>
    [-Blob <String>]
    [-BlobType <String>]
    [-Properties <Hashtable>]
    [-Metadata <Hashtable>]
    [-Tag <Hashtable>]
    [-PremiumPageBlobTier <PremiumPageBlobTier>]
    [-StandardBlobTier <String>]
    [-EncryptionScope <String>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ContainerPipeline

Set-AzStorageBlobContent
    [-File] <String>
    -CloudBlobContainer <CloudBlobContainer>
    [-Blob <String>]
    [-BlobType <String>]
    [-Properties <Hashtable>]
    [-Metadata <Hashtable>]
    [-Tag <Hashtable>]
    [-PremiumPageBlobTier <PremiumPageBlobTier>]
    [-StandardBlobTier <String>]
    [-EncryptionScope <String>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobPipeline

Set-AzStorageBlobContent
    [-File] <String>
    -CloudBlob <CloudBlob>
    [-BlobType <String>]
    [-Properties <Hashtable>]
    [-Metadata <Hashtable>]
    [-Tag <Hashtable>]
    [-PremiumPageBlobTier <PremiumPageBlobTier>]
    [-StandardBlobTier <String>]
    [-EncryptionScope <String>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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

Ejemplos

Ejemplo 1: Carga de un archivo con nombre

Set-AzStorageBlobContent -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

Get-ChildItem -File -Recurse | Set-AzStorageBlobContent -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-AzStorageBlobContent carga los archivos en el contenedor denominado ContosoUploads.

Ejemplo 3: Sobrescribir un blob existente

Get-AzStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzStorageBlobContent -File "ContosoPlanning"

Este comando obtiene el blob denominado Planning2015 en el contenedor ContosoUploads mediante el cmdlet Get-AzStorageBlob 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

Get-AzStorageContainer -Container "ContosoUpload*" | Set-AzStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"

Este comando obtiene el contenedor que comienza con la cadena ContosoUpload mediante el cmdlet Get-AzStorageContainer 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

$Metadata = @{"key" = "value"; "name" = "test"}
Set-AzStorageBlobContent -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 blob con propiedades de blob especificadas y establezca StandardBlobTier como esporádico

$filepath = "c:\temp\index.html"
Set-AzStorageBlobContent -File $filepath -Container "contosouploads" -Properties @{"ContentType" = [System.Web.MimeMapping]::GetMimeMapping($filepath); "ContentMD5" = "i727sP7HigloQDsqadNLHw=="} -StandardBlobTier Cool
AccountName: storageaccountname, ContainerName: contosouploads

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------
index.html           BlockBlob 403116          text/html                      2020-09-22 08:06:53Z Cool                                    False

Este comando carga el archivo c:\temp\index.html en el contenedor denominado contosouploads con las propiedades de blob especificadas y establece StandardBlobTier como Esporádico. Este comando obtiene el valor ContentType establecido en propiedades de blob por [System.Web.MimeMapping]::GetMimeMapping() API.

Ejemplo 7: Carga de un archivo en un blob con ámbito de cifrado

$blob = Set-AzStorageBlobContent  -File "mylocalfile" -Container "mycontainer" -Blob "myblob"  -EncryptionScope "myencryptscope"

$blob.BlobProperties.EncryptionScope
myencryptscope

Este comando carga un archivo en un blob con ámbito de cifrado.

Parámetros

-AsJob

Ejecute el cmdlet en segundo plano.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Blob

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

SendManual
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ContainerPipeline
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-BlobType

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

  • Block
  • Página
  • Append

El valor predeterminado es Block.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Block, Page, Append
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CloudBlob

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

Propiedades de parámetro

Tipo:Microsoft.Azure.Storage.Blob.CloudBlob
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ICloudBlob

Conjuntos de parámetros

BlobPipeline
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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-AzStorageContainer.

Propiedades de parámetro

Tipo:Microsoft.Azure.Storage.Blob.CloudBlobContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ContainerPipeline
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Container

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

SendManual
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Context

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

Propiedades de parámetro

Tipo:IStorageContext
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DefaultProfile

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

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EncryptionScope

Ámbito de cifrado que se va a usar al realizar solicitudes al blob.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-File

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Nombre completo

Conjuntos de parámetros

SendManual
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Force

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Metadata

Especifica los metadatos del blob cargado.

Propiedades de parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PremiumPageBlobTier

Nivel de blob en páginas

Propiedades de parámetro

Tipo:Microsoft.Azure.Storage.Blob.PremiumPageBlobTier
Valor predeterminado:None
Valores aceptados:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Properties

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

Propiedades de parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-StandardBlobTier

Nivel de blob en bloques, los valores válidos son Frecuente,Esporádico/Archivado/Frío. Ver detalles en https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Tag

Etiquetas de blobs

Propiedades de parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 de https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

Microsoft.Azure.Storage.Blob.CloudBlobContainer

Microsoft.Azure.Storage.Blob.CloudBlob

IStorageContext

Salidas

AzureStorageBlob