Get-AzDataLakeGen2ChildItem
Visar en lista över underkataloger och filer från en katalog eller filsystemrot.
Syntax
Get-AzDataLakeGen2ChildItem
[-FileSystem] <String>
[[-Path] <String>]
[-FetchProperty]
[-Recurse]
[-MaxCount <Int32>]
[-ContinuationToken <String>]
[-AsJob]
[-OutputUserPrincipalName]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Cmdleten Get-AzDataLakeGen2ChildItem visar en lista över underkataloger och filer i en katalog eller filsystem i ett Azure-lagringskonto. Den här cmdleten fungerar bara om hierarkisk namnrymd är aktiverad för lagringskontot. Den här typen av konto kan skapas genom att köra cmdleten "New-AzStorageAccount" med "-EnableHierarchicalNamespace $true".
Exempel
Exempel 1: Visa en lista över direktunderobjekt från ett filsystem
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 $superuser
Det här kommandot visar en lista över direktunderobjekt från ett filsystem
Exempel 2: Lista rekursivt från en katalog och hämta egenskaper/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 $superuser
Det här kommandot visar en lista över direktunderobjekt från ett filsystem
Exempel 3: Lista objekt rekursivt från ett filsystem i flera batchar
$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"
I det här exemplet används parametrarna MaxCount och ContinuationToken för att visa objekt rekursivt från ett filsystem i flera batchar. Ett litet MaxCount kan begränsa antalet objekt som returneras från en enskild requst, kan hjälpa till vid tidsgränsfel för åtgärden och begränsa minnesanvändningen för Powershell. De första fyra kommandona tilldelar värden till variabler som ska användas i exemplet. Det femte kommandot anger en Do-While-instruktion som använder cmdleten Get-AzDataLakeGen2ChildItem för att visa objekt. -instruktionen innehåller fortsättningstoken som lagras i variabeln $Token. $Token ändrar värdet när loopen körs. Det sista kommandot använder Echo-kommandot för att visa summan.
Parametrar
-AsJob
Kör cmdlet i bakgrunden
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
Azure Storage-kontextobjekt
Type: | IStorageContext |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ContinuationToken
Fortsättningstoken.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FetchProperty
Hämta egenskaperna för datalake-objektet och ACL.
Type: | SwitchParameter |
Aliases: | FetchPermission |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FileSystem
FileSystem-namn
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MaxCount
Det maximala antalet blobar som kan returneras.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputUserPrincipalName
Om den här parametern speicifieras omvandlas de användaridentitetsvärden som returneras i ägar- och gruppfälten för varje listpost från Microsoft Entra-objekt-ID:t till Användarens huvudnamn. Om den här parametern inte speicifieras returneras värdena som Microsoft Entra-objekt-ID:er. Observera att grupp- och programobjekt-ID:er inte översätts eftersom de inte har unika egna namn.
Type: | SwitchParameter |
Aliases: | UserPrincipalName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Sökvägen i det angivna filsystemet som ska hämtas. Bör vara en katalog i formatet "directory1/directory2/".
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Recurse
Anger om hämtar det underordnade objektet rekursivt. Standardvärdet är falskt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |