Get-AzStorageFile
Enumera los directorios y los archivos de una ruta de acceso.
Syntax
Get-AzStorageFile
[-ShareName] <String>
[[-Path] <String>]
[-ExcludeExtendedInfo]
[-DisAllowTrailingDot]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Get-AzStorageFile
[-Share] <CloudFileShare>
[-ShareClient <ShareClient>]
[[-Path] <String>]
[-ExcludeExtendedInfo]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Get-AzStorageFile
[-Directory] <CloudFileDirectory>
[-ShareDirectoryClient <ShareDirectoryClient>]
[[-Path] <String>]
[-ExcludeExtendedInfo]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Description
El cmdlet Get-AzStorageFile 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
Get-AzStorageFile -ShareName "ContosoShare06" | Where-Object {$_.GetType().Name -eq "AzureStorageFileDirectory"}
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 "AzureStorageFileDirectory".
Ejemplo 2: Enumerar un directorio de archivos
Get-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzStorageFile
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-AzStorageFile 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.
Type: | Nullable<T>[Int32] |
Aliases: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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 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.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
Especifica un contexto de Azure Storage. Para obtener un contexto de almacenamiento, use el cmdlet New-AzStorageContext.
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 |
-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-AzStorageDirectory. También puede usar el cmdlet Get-AzStorageFile para obtener un directorio.
Type: | CloudFileDirectory |
Aliases: | CloudFileDirectory |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisAllowTrailingDot
No permitir el punto final (.) al directorio de sufijo y los nombres de archivo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeExtendedInfo
No incluya información de archivo extendida como marcas de tiempo, ETag, atributos, permissionKey en el archivo de lista y el directorio.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Especifica la ruta de acceso de una carpeta. Si omite el parámetro Path , Get-AzStorageFile enumera los directorios y los archivos del recurso compartido de archivos o directorio especificados. Si incluye el parámetro Path , Get-AzStorageFile devuelve una instancia de un directorio o archivo en la ruta de acceso especificada.
Type: | String |
Position: | 1 |
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 storage devuelve un error.
Type: | Nullable<T>[Int32] |
Aliases: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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-AzStorageShare. Este objeto contiene el contexto storage. Si especifica este parámetro, no especifique el parámetro Context .
Type: | CloudFileShare |
Aliases: | CloudFileShare |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareClient
El objeto ShareClient indicó el recurso compartido donde se enumerarían los archivos o directorios.
Type: | ShareClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareDirectoryClient
El objeto ShareDirectoryClient indicó la carpeta base donde se enumerarían los archivos o directorios.
Type: | ShareDirectoryClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Salidas
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: a lo largo de 2024, eliminaremos gradualmente los problemas de GitHub como mecanismo de comentarios para el contenido y lo reemplazaremos por un nuevo sistema de comentarios. Para obtener más información, consulte:Enviar y ver comentarios de