Partager via

Get-AzureStorageFile

  • Référence
Module:
Azure.Storage

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

Avertissement

Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntax

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

L’applet de commande Get-Azure Stockage File 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 d’accès spécifié. Cette applet de commande retourne les objets Azure Stockage File et Azure Stockage Directory. 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

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

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’opérateur où à l’aide de l’opérateur de pipeline, puis dis carte tous les objets dont le type n’est pas « CloudFileDirectory ».

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

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

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’applet de commande Get-Azure Stockage File 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]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

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

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Directory

Spécifie un dossier en tant qu’objet CloudFileDirectory . Cette applet de commande obtient le dossier spécifié par ce paramètre. Pour obtenir un répertoire, utilisez l’applet de commande New-Azure Stockage Directory. Vous pouvez également utiliser l’applet de commande Get-Azure Stockage File pour obtenir un répertoire.

Type:CloudFileDirectory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Spécifie le chemin d’accès d’un dossier. Si vous omettez le paramètre Path, Get-Azure Stockage File 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-Azure Stockage File retourne une instance d’un répertoire ou d’un fichier dans le chemin spécifié.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Stockage retourne une erreur.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Share

Spécifie un objet CloudFileShare . Cette applet de commande obtient un fichier ou un répertoire à partir du partage de fichiers spécifié par ce paramètre. Pour obtenir un objet CloudFileShare, utilisez l’applet de commande Get-Azure Stockage Share. Cet objet contient le contexte Stockage. Si vous spécifiez ce paramètre, ne spécifiez pas le paramètre Context .

Type:CloudFileShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entrées

CloudFileShare

Paramètres : Partager (ByValue)

CloudFileDirectory

Paramètres : Répertoire (ByValue)

IStorageContext

Sorties

CloudFile