Partager via

Get-AzStorageFile

  • Référence
Module:
Az.Storage

Répertorie les répertoires et les fichiers pour un chemin d’accès.

Syntaxe

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

Description

La Get-AzStorageFile cmdlet répertorie les répertoires et les fichiers du partage ou du répertoire que vous spécifiez. Spécifiez le paramètre Path pour obtenir une instance d’un répertoire ou d’un fichier dans le chemin spécifié. Cette applet de commande retourne objets azureStorageFile et AzureStorageDirectory. Vous pouvez utiliser la propriété IsDirectory pour faire la distinction entre les dossiers et les fichiers.

Exemples

Exemple 1 : Répertorier les répertoires dans un partage

Get-AzStorageFile -ShareName "ContosoShare06" | Where-Object {$_.GetType().Name -eq "AzureStorageFileDirectory"}

Cette commande répertorie uniquement les répertoires du partage ContosoShare06. Il récupère d’abord les fichiers et les répertoires, les transmet à l'où opérateur à l’aide de l’opérateur de pipeline, puis ignore tous les objets dont le type n’est pas « AzureStorageFileDirectory ».

Exemple 2 : Répertorier un répertoire de fichiers

Get-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzStorageFile

Cette commande répertorie les fichiers et dossiers du répertoire ContosoWorkingFolder sous le partage ContosoShare06. Elle obtient d’abord l’instance de répertoire, puis la pipeline vers l'Get-AzStorageFile cmdlet pour répertorier le répertoire.

Paramètres

-ClientTimeoutPerRequest

Spécifie l’intervalle de délai d’attente côté client, en secondes, pour une demande de service. Si l’appel précédent échoue dans l’intervalle spécifié, cette applet de commande retente la requête. Si cette applet de commande ne reçoit pas de réponse réussie avant l’expiration de l’intervalle, cette applet de commande retourne une erreur.

Type:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ConcurrentTaskCount

Spécifie le nombre maximal d’appels réseau simultanés. Vous pouvez utiliser ce paramètre pour limiter l’accès concurrentiel pour limiter l’utilisation du processeur local et de la bande passante en spécifiant le nombre maximal d’appels réseau simultanés. La valeur spécifiée est un nombre absolu et n’est pas multipliée par le nombre de cœurs. Ce paramètre peut aider à atténuer les problèmes de connexion réseau dans des environnements à faible bande passante, tels que 100 kilobits par seconde. La valeur par défaut est 10.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Context

Spécifie un contexte de stockage Azure. Pour obtenir un contexte de stockage, utilisez l’applet de commande New-AzStorageContext.

Type:IStorageContext
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisAllowTrailingDot

Interdire le point de fin (.) au répertoire de suffixe et aux noms de fichiers.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ExcludeExtendedInfo

N’incluez pas d’informations de fichier étendues telles que les horodatages, ETag, les attributs, permissionKey dans le fichier de liste et le répertoire.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Spécifie le chemin d’accès d’un dossier. Si vous omettez le paramètre Path, Get-AzStorageFile répertorie les répertoires et fichiers dans le partage de fichiers ou le répertoire spécifiés. Si vous incluez le paramètre Path, Get-AzStorageFile retourne une instance d’un répertoire ou d’un fichier dans le chemin spécifié.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServerTimeoutPerRequest

Spécifie l’intervalle de délai d’expiration côté service, en secondes, pour une demande. Si l’intervalle spécifié s’écoule avant que le service traite la requête, le service de stockage retourne une erreur.

Type:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ShareClient

L’objet ShareClient a indiqué le partage dans lequel les fichiers/répertoires seraient répertoriés.

Type:ShareClient
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ShareDirectoryClient

L’objet ShareDirectoryClient a indiqué le dossier de base dans lequel les fichiers/répertoires seraient répertoriés.

Type:ShareDirectoryClient
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ShareName

Spécifie le nom du partage de fichiers. Cette applet de commande obtient un fichier ou un répertoire à partir du partage de fichiers spécifié par ce paramètre.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

ShareClient

ShareDirectoryClient

IStorageContext

Sorties

AzureStorageFile