Compartir a través de


Get-AzureStorageFileContent

Descarga el contenido de un archivo.

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.

Syntax

Get-AzureStorageFileContent
   [-ShareName] <String>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-Share] <CloudFileShare>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-File] <CloudFile>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Get-AzureStorageFileContent descarga el contenido de un archivo y, a continuación, lo guarda en un destino que especifique. Este cmdlet no devuelve el contenido del archivo.

Ejemplos

Ejemplo 1: Descargar un archivo de una carpeta

PS C:\>Get-AzureStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"

Este comando descarga un archivo denominado CurrentDataFile en la carpeta ContosoWorkingFolder del recurso compartido de archivos ContosoShare06 a la carpeta actual.

Ejemplo 2: Descargar los archivos en el recurso compartido de archivos de ejemplo

PS C:\>Get-AzureStorageFile -ShareName sample | ? {$_.GetType().Name -eq "CloudFile"} | Get-AzureStorageFileContent

En este ejemplo se descargan los archivos en el recurso compartido de archivos de ejemplo.

Parámetros

-CheckMd5

Si especifica la ruta de acceso de un archivo que no existe, este cmdlet crea ese archivo y guarda el contenido en el nuevo archivo. Si especifica una ruta de acceso de un archivo que ya existe y especifica el parámetro Force , el cmdlet sobrescribe el archivo. Si especifica una ruta de acceso de un archivo existente y no especifica Force, el cmdlet le pedirá antes de continuar. Si especifica la ruta de acceso de una carpeta, este cmdlet intenta crear un archivo que tenga el nombre del archivo de Almacenamiento de Azure.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientTimeoutPerRequest

Si especifica la ruta de acceso de un archivo que no existe, este cmdlet crea ese archivo y guarda el contenido en el nuevo archivo. Si especifica una ruta de acceso de un archivo que ya existe y especifica el parámetro Force , el cmdlet sobrescribe el archivo. Si especifica una ruta de acceso de un archivo existente y no especifica Force, el cmdlet le pedirá antes de continuar. Si especifica la ruta de acceso de una carpeta, este cmdlet intenta crear un archivo que tenga el nombre del archivo de Almacenamiento de Azure.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

Si especifica la ruta de acceso de un archivo que no existe, este cmdlet crea ese archivo y guarda el contenido en el nuevo archivo. Si especifica una ruta de acceso de un archivo que ya existe y especifica el parámetro Force , el cmdlet sobrescribe el archivo. Si especifica una ruta de acceso de un archivo existente y no especifica Force, el cmdlet le pedirá antes de continuar. Si especifica la ruta de acceso de una carpeta, este cmdlet intenta crear un archivo que tenga el nombre del archivo de Almacenamiento de Azure.

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

-Context

Si especifica la ruta de acceso de un archivo que no existe, este cmdlet crea ese archivo y guarda el contenido en el nuevo archivo. Si especifica una ruta de acceso de un archivo que ya existe y especifica el parámetro Force , el cmdlet sobrescribe el archivo. Si especifica una ruta de acceso de un archivo existente y no especifica Force, el cmdlet le pedirá antes de continuar. Si especifica la ruta de acceso de una carpeta, este cmdlet intenta crear un archivo que tenga el nombre del archivo de Almacenamiento de Azure.

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 ruta de acceso de destino. Este cmdlet descarga el contenido del archivo en la ubicación que especifica este parámetro. Si especifica la ruta de acceso de un archivo que no existe, este cmdlet crea ese archivo y guarda el contenido en el nuevo archivo. Si especifica una ruta de acceso de un archivo que ya existe y especifica el parámetro Force , el cmdlet sobrescribe el archivo. Si especifica una ruta de acceso de un archivo existente y no especifica Force, el cmdlet le pedirá antes de continuar. Si especifica la ruta de acceso de una carpeta, este cmdlet intenta crear un archivo que tenga el nombre del archivo de Almacenamiento de Azure.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Directory

Especifica una carpeta como un objeto CloudFileDirectory . Este cmdlet obtiene contenido de un archivo de la carpeta que especifica este parámetro. Para obtener un directorio, use el cmdlet New-AzureStorageDirectory. También puede usar el cmdlet Get-AzureStorageFile para obtener un directorio.

Type:CloudFileDirectory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-File

Especifica un archivo como un objeto CloudFile . Este cmdlet obtiene el archivo que especifica este parámetro. Para obtener un objeto CloudFile , use el cmdlet Get-AzureStorageFile.

Type:CloudFile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Force

Si especifica la ruta de acceso de un archivo que no existe, este cmdlet crea ese archivo y guarda el contenido en el nuevo archivo. Si especifica una ruta de acceso de un archivo que ya existe y especifica el parámetro Force , el cmdlet sobrescribe el archivo. Si especifica una ruta de acceso de un archivo existente y no especifica Force, el cmdlet le pedirá antes de continuar. Si especifica la ruta de acceso de una carpeta, este cmdlet intenta crear un archivo que tenga el nombre del archivo de Almacenamiento de Azure.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Si especifica la ruta de acceso de un archivo que no existe, este cmdlet crea ese archivo y guarda el contenido en el nuevo archivo. Si especifica una ruta de acceso de un archivo que ya existe y especifica el parámetro Force , el cmdlet sobrescribe el archivo. Si especifica una ruta de acceso de un archivo existente y no especifica Force, el cmdlet le pedirá antes de continuar. Si especifica la ruta de acceso de una carpeta, este cmdlet intenta crear un archivo que tenga el nombre del archivo de Almacenamiento de Azure.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Especifica la ruta de acceso de un archivo. Este cmdlet obtiene el contenido del archivo que especifica este parámetro. Si el archivo no existe, este cmdlet devuelve un error.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Si especifica la ruta de acceso de un archivo que no existe, este cmdlet crea ese archivo y guarda el contenido en el nuevo archivo. Si especifica una ruta de acceso de un archivo que ya existe y especifica el parámetro Force , el cmdlet sobrescribe el archivo. Si especifica una ruta de acceso de un archivo existente y no especifica Force, el cmdlet le pedirá antes de continuar. Si especifica la ruta de acceso de una carpeta, este cmdlet intenta crear un archivo que tenga el nombre del archivo de Almacenamiento de Azure.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Share

Especifica un objeto CloudFileShare . Este cmdlet descarga el contenido del archivo en el recurso compartido que especifica este parámetro. Para obtener un objeto CloudFileShare , use el cmdlet Get-AzureStorageShare. Este objeto contiene el contexto de almacenamiento. Si especifica este parámetro, no especifique el parámetro Context .

Type:CloudFileShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareName

Especifica el nombre del recurso compartido de archivos. Este cmdlet descarga el contenido del archivo en el recurso compartido que especifica este parámetro.

Type:String
Position:0
Default value:None
Required:True
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

CloudFileShare

Parámetros: Compartir (ByValue)

CloudFileDirectory

Parámetros: Directory (ByValue)

CloudFile

Parámetros: Archivo (ByValue)

IStorageContext

Salidas

CloudFile