Get-AzDataLakeGen2ChildItem
Elenca sottodirectory e file da una directory o da una radice del file system.
Sintassi
Get-AzDataLakeGen2ChildItem
[-FileSystem] <String>
[[-Path] <String>]
[-FetchProperty]
[-Recurse]
[-MaxCount <Int32>]
[-ContinuationToken <String>]
[-AsJob]
[-OutputUserPrincipalName]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Descrizione
Il cmdlet Get-AzDataLakeGen2ChildItem elenca le sottodirectory e i file in una directory o in un file system in un account di archiviazione di Azure. Questo cmdlet funziona solo se la Namespace gerarchica è abilitata per l'account di archiviazione. Questo tipo di account può essere creato eseguendo il cmdlet "New-AzStorageAccount" con "-EnableHierarchicalNamespace $true".
Esempio
Esempio 1: Elencare gli elementi secondari diretti da un file system
Get-AzDataLakeGen2ChildItem -FileSystem "filesystem1"
FileSystem Name: filesystem1
Path IsDirectory Length LastModified Permissions Owner Group
---- ----------- ------ ------------ ----------- ----- -----
dir1 True 2020-03-13 13:07:34Z rwxr-x--- $superuser $superuser
dir2 True 2020-03-23 09:28:36Z rwxr-x--- $superuser $superuserQuesto comando elenca gli elementi secondari diretti di un file system
Esempio 2: Elencare in modo ricorsivo da una directory e recuperare proprietà/ACL
Get-AzDataLakeGen2ChildItem -FileSystem "filesystem1" -Path "dir1/" -Recurse -FetchProperty
FileSystem Name: filesystem1
Path IsDirectory Length LastModified Permissions Owner Group
---- ----------- ------ ------------ ----------- ----- -----
dir1/dir3 True 2020-03-23 09:34:31Z rwx---rwx $superuser $superuser
dir1/file1 False 1024 2020-03-23 09:29:18Z rwx---rwx $superuser $superuser
dir1/testfile_1K_0 False 1024 2020-03-23 09:29:21Z rw-r----- $superuser $superuserQuesto comando elenca gli elementi secondari diretti di un file system
Esempio 3: Elencare gli elementi in modo ricorsivo da un file system in più batch
$MaxReturn = 1000
$FileSystemName = "filesystem1"
$Total = 0
$Token = $Null
do
{
$items = Get-AzDataLakeGen2ChildItem -FileSystem $FileSystemName -Recurse -MaxCount $MaxReturn -ContinuationToken $Token
$Total += $items.Count
if($items.Length -le 0) { Break;}
$Token = $items[$items.Count -1].ContinuationToken;
}
While ($null -ne $Token)
Echo "Total $Total items in Filesystem $FileSystemName"In questo esempio vengono usati i parametri MaxCount e ContinuationToken per elencare gli elementi in modo ricorsivo da un file system in più batch. Un piccolo MaxCount può limitare il conteggio degli elementi restituiti da un singolo tentativo, può contribuire al timeout dell'operazione e limitare l'utilizzo della memoria di PowerShell. I primi quattro comandi assegnano valori alle variabili da usare nell'esempio. Il quinto comando specifica un'istruzione Do-While che usa il cmdlet Get-AzDataLakeGen2ChildItem per elencare gli elementi. L'istruzione include il token di continuazione archiviato nella variabile $Token. $Token cambia valore durante l'esecuzione del ciclo. Il comando finale usa il comando Echo per visualizzare il totale.
Parametri
-AsJob
Eseguire il cmdlet in background
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Context
oggetto Context Archiviazione di Azure
| Tipo: | IStorageContext |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-ContinuationToken
Token di continuazione.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| 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 |
-FetchProperty
Recuperare le proprietà dell'elemento datalake e LCL.
| Tipo: | SwitchParameter |
| Alias: | FetchPermission |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-FileSystem
Nome filesystem
| Tipo: | String |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-MaxCount
Numero massimo di BLOB che possono restituire.
| Tipo: | Nullable<T>[Int32] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-OutputUserPrincipalName
Se specifica questo parametro, i valori identity utente restituiti nei campi proprietario e gruppo di ogni voce dell'elenco verranno trasformati dagli ID oggetto Microsoft Entra ai nomi delle entità utente. Se non specifica questo parametro, i valori verranno restituiti come ID oggetto Microsoft Entra. Si noti che gli ID oggetto di gruppo e applicazione non vengono convertiti perché non hanno nomi descrittivi univoci.
| Tipo: | SwitchParameter |
| Alias: | UserPrincipalName |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Path
Percorso nel file system specificato che deve essere recuperato. Deve essere una directory nel formato 'directory1/directory2/'.
| Tipo: | String |
| Posizione: | 1 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Recurse
Indica se otterrà in modo ricorsivo l'elemento figlio. L'impostazione predefinita è false.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |