Get-AzStorageBlobContent
Descarga un blob de almacenamiento.
Syntax
Get-AzStorageBlobContent
[-Blob] <String>
[-Container] <String>
[-Destination <String>]
[-CheckMd5]
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-AzStorageBlobContent
-CloudBlob <CloudBlob>
[-BlobBaseClient <BlobBaseClient>]
[-Destination <String>]
[-CheckMd5]
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-AzStorageBlobContent
-CloudBlobContainer <CloudBlobContainer>
[-Blob] <String>
[-Destination <String>]
[-CheckMd5]
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-AzStorageBlobContent
[-Destination <String>]
-AbsoluteUri <String>
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Get-AzStorageBlobContent descarga el blob de almacenamiento especificado. Si el nombre del blob no es válido para el equipo local, este cmdlet lo resuelve automáticamente si es posible.
Ejemplos
Ejemplo 1: Descarga del contenido del blob por nombre
Get-AzStorageBlobContent -Container "ContainerName" -Blob "Blob" -Destination "C:\test\"
Este comando descarga un blob por nombre.
Ejemplo 2: Descarga del contenido del blob mediante la canalización
Get-AzStorageBlob -Container containername -Blob blobname | Get-AzStorageBlobContent
Este comando usa la canalización para buscar y descargar contenido de blob.
Ejemplo 3: Descarga del contenido del blob mediante la canalización y un carácter comodín
Get-AzStorageContainer container* | Get-AzStorageBlobContent -Blob "cbox.exe" -Destination "C:\test"
En este ejemplo se usa el carácter comodín asterisco y la canalización para buscar y descargar contenido de blob.
Ejemplo 4: Obtención de un objeto de blob y guárdelo en una variable y, a continuación, descargue el contenido del blob con el objeto blob.
$blob = Get-AzStorageBlob -Container containername -Blob blobname
Get-AzStorageBlobContent -CloudBlob $blob.ICloudBlob -Destination "C:\test"
En este ejemplo, primero se obtiene un objeto de blob y se guarda en una variable y, a continuación, se descarga el contenido del blob con el objeto blob.
Ejemplo 5: Descarga de contenido de blobs con URI de blob
Get-AzStorageBlobContent -Uri $blobUri -Destination "C:\test" -Force
En este ejemplo se descargará un contenido de blob con URI, el URI puede ser un URI con el token de Sas. Si el blob está en una cuenta de disco administrado y el servidor requiere un token de portador además del URI de Sas para descargar, el cmdlet intentará generar un token de portador con la audiencia devuelta por el servidor y el usuario de AAD de inicio de sesión credentail, descargue el blob con el URI de Sas y el token de portador.
Parámetros
-AbsoluteUri
URI de blob desde el que se va a descargar.
Type: | String |
Aliases: | Uri, BlobUri |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AsJob
Ejecute el cmdlet en segundo plano.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Blob
Especifica el nombre del blob que se va a descargar.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BlobBaseClient
BlobBaseClient (objeto)
Type: | BlobBaseClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CheckMd5
Especifica si se debe comprobar la suma md5 del archivo descargado.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Nullable<T>[Int32] |
Aliases: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CloudBlob
Especifica un blob en la nube. Para obtener un objeto CloudBlob , use el cmdlet Get-AzStorageBlob.
Type: | CloudBlob |
Aliases: | ICloudBlob |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CloudBlobContainer
Especifica un objeto CloudBlobContainer de la biblioteca cliente de Azure Storage. Puede crearlo o usar el cmdlet Get-AzStorageContainer.
Type: | CloudBlobContainer |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Container
Especifica el nombre del contenedor que tiene el blob que desea descargar.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
Especifica la cuenta de Almacenamiento de Azure desde la que desea descargar el contenido del blob. Puede usar el cmdlet New-AzStorageContext para crear un contexto de almacenamiento.
Type: | IStorageContext |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Destination
Especifica la ubicación para almacenar el archivo descargado.
Type: | String |
Aliases: | Path |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Sobrescribe un archivo existente sin confirmación.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Nullable<T>[Int32] |
Aliases: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Salidas
Notas
- Si el nombre del blob no es válido para el equipo local, este cmdlet lo aplica, si es posible.
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de