Get-AzStorageFile
Elenca directory e file per un percorso.
Sintassi
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>]
Descrizione
Il cmdlet Get-AzStorageFile 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 AzureStorageFile e AzureStorageDirectory . È possibile utilizzare la proprietà IsDirectory per distinguere tra cartelle e file.
Esempio
Esempio 1: Elencare le directory in una condivisione
Get-AzStorageFile -ShareName "ContosoShare06" | Where-Object {$_.GetType().Name -eq "AzureStorageFileDirectory"}
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 è "AzureStorageFileDirectory".
Esempio 2: Elencare una directory file
Get-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzStorageFile
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-AzStorageFile 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] |
Alias: | ClientTimeoutPerRequestInSeconds |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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] |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Context
Specifica un contesto di Archiviazione di Azure. Per ottenere un contesto di archiviazione, usare il cmdlet New-AzStorageContext.
Tipo: | IStorageContext |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-DefaultProfile
Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.
Tipo: | IAzureContextContainer |
Alias: | AzureRmContext, AzureCredential |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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-AzStorageDirectory. È anche possibile usare il cmdlet Get-AzStorageFile per ottenere una directory.
Tipo: | CloudFileDirectory |
Alias: | CloudFileDirectory |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-DisAllowTrailingDot
Non consentire il punto finale (.) per suffisso directory e nomi di file.
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ExcludeExtendedInfo
Non includere informazioni sui file estesi, ad esempio timestamp, ETag, attributi, permissionKey nel file di elenco e nella directory.
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Path
Specifica il percorso di una cartella. Se si omette il parametro Path , Get-AzStorageFile elenca le directory e i file nella condivisione file o nella directory specificata. Se si include il parametro Path , Get-AzStorageFile restituisce un'istanza di una directory o di un file nel percorso specificato.
Tipo: | String |
Posizione: | 1 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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 di archiviazione restituisce un errore.
Tipo: | Nullable<T>[Int32] |
Alias: | ServerTimeoutPerRequestInSeconds |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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-AzStorageShare . Questo oggetto contiene il contesto di archiviazione. Se si specifica questo parametro, non specificare il parametro Context .
Tipo: | CloudFileShare |
Alias: | CloudFileShare |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-ShareClient
L'oggetto ShareClient indica la condivisione in cui verranno elencati i file/directory.
Tipo: | ShareClient |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-ShareDirectoryClient
L'oggetto ShareDirectoryClient indica la cartella di base in cui verranno elencati i file/directory.
Tipo: | ShareDirectoryClient |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | 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 |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |