Compartir a través de

Get-AzStorageFile

Módulo:
Az.Storage Module

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

Sintaxis

ShareName (valor predeterminado) 

Get-AzStorageFile
    [-ShareName] <String>
    [[-Path] <String>]
    [-ExcludeExtendedInfo]
    [-DisAllowTrailingDot]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Share 

Get-AzStorageFile
    [-ShareClient] <ShareClient>
    [[-Path] <String>]
    [-ExcludeExtendedInfo]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Directory 

Get-AzStorageFile
    [-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.

Ejemplo 3: Enumerar archivos y directorios en un recurso compartido y excluir información extendida

Get-AzStorageFile -ShareName "ContosoShare06" -ExcludeExtendedInfo

Este comando enumera los archivos y carpetas de en el recurso compartido ContosoShare06 y excluye la información de archivo extendida, como marcas de tiempo, ETag, atributos, permissionKey en el archivo de lista y el directorio. Actualmente, se necesitará -ExcludeExtendedInfo para enumerar archivos y directorios del recurso compartido de archivos NFS o de un directorio en el recurso compartido de archivos NFS.

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.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Context

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

Propiedades de parámetro

Tipo:IStorageContext
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DisAllowTrailingDot

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ShareName
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ExcludeExtendedInfo

No incluya información de archivo extendida como marcas de tiempo, ETag, atributos, permissionKey en el archivo de lista y el directorio.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ShareClient

El objeto ShareClient indicó el recurso compartido donde se enumerarían los archivos o directorios.

Propiedades de parámetro

Tipo:ShareClient
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Share
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ShareDirectoryClient

El objeto ShareDirectoryClient indicó la carpeta base donde se enumerarían los archivos o directorios.

Propiedades de parámetro

Tipo:ShareDirectoryClient
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Directory
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ShareName
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

ShareClient

ShareDirectoryClient

IStorageContext

Salidas

AzureStorageFile