Condividi tramite

Get-AzureStorageFile

  • Riferimento
Modulo:
Azure.Storage

Elenca directory e file per un percorso.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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>]

Descrizione

Il cmdlet Get-Azure Archiviazione File elenca directory e file per la condivisione o la directory specificata. Specificare il parametro Path per ottenere un'istanza di una directory o di un file nel percorso specificato. Questo cmdlet restituisce gli oggetti Azure Archiviazione File e Azure Archiviazione Directory. È possibile utilizzare la proprietà IsDirectory per distinguere tra cartelle e file.

Esempio

Esempio 1: Elencare le directory in una condivisione

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

Questo comando elenca solo le directory nella condivisione ContosoShare06. Recupera prima sia file che directory, li passa all'operatore where usando l'operatore pipeline, quindi rimuove tutti gli oggetti il cui tipo non è "CloudFileDirectory".

Esempio 2: Elencare una directory file

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

Questo comando elenca i file e le cartelle nella directory ContosoWorkingFolder nella condivisione ContosoShare06. Ottiene prima l'istanza della directory e quindi la pipeline al cmdlet Get-Azure Archiviazione File per elencare la directory.

Parametri

-ClientTimeoutPerRequest

Specifica l'intervallo di timeout sul lato client, espresso in secondi, per una richiesta di servizio. Se la chiamata precedente ha esito negativo entro l'intervallo specificato, questo cmdlet ritenta la richiesta. Se questo cmdlet non riceve una risposta corretta prima della scadenza dell'intervallo, questo cmdlet restituisce un errore.

Tipo:Nullable<T>[Int32]
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

Specifica il numero massimo di chiamate di rete simultanee. È possibile usare questo parametro per limitare la concorrenza per limitare l'utilizzo della CPU e della larghezza di banda locali specificando il numero massimo di chiamate di rete simultanee. Il valore specificato è un conteggio assoluto e non viene moltiplicato per il numero di core. Questo parametro consente di ridurre i problemi di connessione di rete in ambienti a larghezza di banda ridotta, ad esempio 100 kilobit al secondo. Il valore predefinito è 10.

Tipo:Nullable<T>[Int32]
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Specifica un contesto di Archiviazione di Azure. Per ottenere un contesto di Archiviazione, usare il cmdlet New-Azure Archiviazione Context.

Tipo:IStorageContext
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Directory

Specifica una cartella come oggetto CloudFileDirectory . Questo cmdlet ottiene la cartella specificata da questo parametro. Per ottenere una directory, usare il cmdlet New-Azure Archiviazione Directory. È anche possibile usare il cmdlet Get-Azure Archiviazione File per ottenere una directory.

Tipo:CloudFileDirectory
Position:0
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Specifica il percorso di una cartella. Se si omette il parametro Path, Get-Azure Archiviazione File elenca le directory e i file nella condivisione file o nella directory specificata. Se si include il parametro Path, Get-Azure Archiviazione File restituisce un'istanza di una directory o di un file nel percorso specificato.

Tipo:String
Position:1
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Specifica l'intervallo di timeout sul lato servizio, espresso in secondi, per una richiesta. Se l'intervallo specificato è trascorso prima che il servizio elabori la richiesta, il servizio Archiviazione restituisce un errore.

Tipo:Nullable<T>[Int32]
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Share

Specifica un oggetto CloudFileShare . Questo cmdlet ottiene un file o una directory dalla condivisione file specificata da questo parametro. Per ottenere un oggetto CloudFileShare, usare il cmdlet Get-Azure Archiviazione Share. Questo oggetto contiene il contesto di Archiviazione. Se si specifica questo parametro, non specificare il parametro Context .

Tipo:CloudFileShare
Position:0
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareName

Specifica il nome della condivisione file. Questo cmdlet ottiene un file o una directory dalla condivisione file specificata da questo parametro.

Tipo:String
Position:0
valore predefinito:None
Necessario:True
Accept pipeline input:False
Accept wildcard characters:False

Input

CloudFileShare

Parametri: Share (ByValue)

CloudFileDirectory

Parametri: Directory (ByValue)

IStorageContext

Output

CloudFile