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.

Sintaxis

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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

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

-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.

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

-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.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:CloudFileDirectory
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:CloudFile
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 .

Tipo:CloudFileShare
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
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

CloudFileShare

Parámetros: Compartir (ByValue)

CloudFileDirectory

Parámetros: Directory (ByValue)

CloudFile

Parámetros: Archivo (ByValue)

IStorageContext

Salidas

CloudFile