Compartir a través de

Get-AzureStorageFile

  • Referencia
Módulo:
Azure.Storage

Enumera los directorios y los archivos de una ruta de acceso.

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-AzureStorageFile
   [-ShareName] <String>
   [[-Path] <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzureStorageFile
   [-Share] <CloudFileShare>
   [[-Path] <String>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzureStorageFile
   [-Directory] <CloudFileDirectory>
   [[-Path] <String>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

El cmdlet Get-AzureStorageFile enumera directorios y archivos para el recurso compartido o directorio que especifique. Especifique el parámetro Path para obtener una instancia de un directorio o archivo en la ruta de acceso especificada. Este cmdlet devuelve objetos AzureStorageFile y AzureStorageDirectory . Puede usar la propiedad IsDirectory para distinguir entre carpetas y archivos.

Ejemplos

Ejemplo 1: Enumerar directorios en un recurso compartido

PS C:\>Get-AzureStorageFile -ShareName "ContosoShare06" | where {$_.GetType().Name -eq "CloudFileDirectory"}

Este comando muestra solo los directorios del recurso compartido ContosoShare06. Primero recupera los archivos y directorios, los pasa al operador where mediante el operador de canalización y, a continuación, descarta los objetos cuyo tipo no es "CloudFileDirectory".

Ejemplo 2: Enumerar un directorio de archivos

PS C:\> Get-AzureStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzureStorageFile

Este comando enumera los archivos y carpetas del directorio ContosoWorkingFolder en el recurso compartido ContosoShare06. Primero obtiene la instancia de directorio y, a continuación, la canaliza al cmdlet Get-AzureStorageFile para enumerar el directorio.

Parámetros

-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 dentro del intervalo especificado, este cmdlet vuelve a intentar 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]
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 mitigar 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

-Context

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

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

-Directory

Especifica una carpeta como un objeto CloudFileDirectory . Este cmdlet obtiene 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

-Path

Especifica la ruta de acceso de una carpeta. Si omite el parámetro Path , Get-AzureStorageFile enumera los directorios y los archivos del recurso compartido de archivos o directorio especificados. Si incluye el parámetro Path , Get-AzureStorageFile devuelve una instancia de un directorio o archivo en la ruta de acceso especificada.

Tipo:String
Posición:1
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 storage devuelve un error.

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 obtiene un archivo o directorio del recurso compartido de archivos que especifica este parámetro. Para obtener un objeto CloudFileShare , use el cmdlet Get-AzureStorageShare. Este objeto contiene el contexto storage. 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 obtiene un archivo o directorio del recurso compartido de archivos 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

Entradas

CloudFileShare

Parámetros: Compartir (ByValue)

CloudFileDirectory

Parámetros: Directory (ByValue)

IStorageContext

Salidas

CloudFile