Get-AzStorageFileContent

Módulo:

Az.Storage

Descarga el contenido de un archivo.

Sintaxis

Get-AzStorageFileContent
   [-ShareName] <String>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Get-AzStorageFileContent
   [-ShareClient] <ShareClient>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Get-AzStorageFileContent
   [-ShareDirectoryClient] <ShareDirectoryClient>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Get-AzStorageFileContent
   [-ShareFileClient] <ShareFileClient>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Description

El cmdlet Get-AzStorageFileContent 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

Get-AzStorageFileContent -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: Descarga los archivos en el recurso compartido de archivos de ejemplo

Get-AzStorageFile -ShareName sample | Where-Object {$_.GetType().Name -eq "AzureStorageFile"} | Get-AzStorageFileContent

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

Ejemplo 3: Descargar un archivo de Azure en un archivo local y conservar las propiedades SMB de Azure File (File Attributtes, File Creation Time, File Last Write Time) en el archivo local.

Get-AzStorageFileContent -ShareName sample -Path "dir1/file1" -Destination $localFilePath -PreserveSMBAttribute

En este ejemplo se descarga un archivo de Azure en un archivo local y se conservan las propiedades de SMB de azure File (File Attributtes, File Creation Time, File Last Write Time) en el archivo local.

Parámetros

-AsJob

Ejecute el cmdlet en segundo plano.

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

-CheckMd5

Especifica si se debe comprobar la suma md5 del archivo descargado.

Tipo:	SwitchParameter
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]
Alias:	ClientTimeoutPerRequestInSeconds
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
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 pide 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

Especifica un contexto de Azure Storage. Para obtener un contexto, use el cmdlet New-AzStorageContext.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan 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

-DisAllowTrailingDot

No permitir el punto final (.) al directorio de sufijo y los nombres de archivo.

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

Indica que este cmdlet devuelve el objeto AzureStorageFile que descarga.

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

-PreserveSMBAttribute

Mantenga las propiedades SMB de archivo de origen (File Attributtes, File Creation Time, File Last Write Time) en el archivo de destino. Este parámetro solo está disponible en Windows.

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

-ShareClient

El objeto ShareClient indicó el recurso compartido donde se descargaría el archivo.

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

-ShareDirectoryClient

El objeto ShareDirectoryClient indicó el directorio en la nube donde se descargaría el archivo.

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

-ShareFileClient

El objeto ShareFileClient indica que se va a descargar el archivo en la nube.

Tipo:	ShareFileClient
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 el cmdlet se ejecuta. 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

ShareClient

ShareDirectoryClient

ShareFileClient

IStorageContext

Salidas

AzureStorageFile

Vínculos relacionados

• Get-AzStorageFile
• Set-AzStorageFileContent