Delen via

Get-AzDataLakeGen2ChildItem

  • Referentie
Module:
Az.Storage

Een lijst met submappen en bestanden uit een map of bestandssysteemhoofdmap.

Syntaxis

Get-AzDataLakeGen2ChildItem
   [-FileSystem] <String>
   [[-Path] <String>]
   [-FetchProperty]
   [-Recurse]
   [-MaxCount <Int32>]
   [-ContinuationToken <String>]
   [-AsJob]
   [-OutputUserPrincipalName]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

De Get-AzDataLakeGen2ChildItem cmdlet bevat submappen en bestanden in een map of bestandssysteem in een Azure-opslagaccount. Deze cmdlet werkt alleen als hiërarchische naamruimte is ingeschakeld voor het opslagaccount. Dit type account kan worden gemaakt door de cmdlet New-AzStorageAccount uit te voeren met "-EnableHierarchicalNamespace $true".

Voorbeelden

Voorbeeld 1: De directe subitems van een bestandssysteem weergeven

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

Met deze opdracht worden de directe subitems uit een bestandssysteem weergegeven

Voorbeeld 2: Recursief weergeven vanuit een map en Eigenschappen/ACL ophalen

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

Met deze opdracht worden de directe subitems uit een bestandssysteem weergegeven

Voorbeeld 3: Items recursief weergeven vanuit een bestandssysteem in meerdere batches

$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 dit voorbeeld worden de parameters MaxCount en ContinuationToken gebruikt om items recursief weer te geven vanuit een bestandssysteem in meerdere batches. Een kleine MaxCount- kan het aantal items beperken dat wordt geretourneerd uit één regel, kan helpen bij een time-outfout voor bewerkingen en het geheugengebruik van PowerShell beperken. Met de eerste vier opdrachten worden waarden toegewezen aan variabelen die in het voorbeeld moeten worden gebruikt. De vijfde opdracht geeft een Do-While instructie die gebruikmaakt van de Get-AzDataLakeGen2ChildItem cmdlet om items weer te geven. De instructie bevat het vervolgtoken dat is opgeslagen in de $Token variabele. $Token de waarde wijzigt terwijl de lus wordt uitgevoerd. De laatste opdracht maakt gebruik van de opdracht Echo om het totaal weer te geven.

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Context

Azure Storage-contextobject

Type:IStorageContext
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ContinuationToken

Vervolgtoken.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FetchProperty

Haal de eigenschappen van het datalake-item en de ACL op.

Type:SwitchParameter
Aliassen:FetchPermission
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FileSystem

Bestandsnaam

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-MaxCount

Het maximumaantal blobs dat kan worden geretourneerd.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OutputUserPrincipalName

Als u deze parameter speicificeert, worden de gebruikersidentiteitswaarden die worden geretourneerd in de eigenaar- en groepsvelden van elke lijstvermelding, getransformeerd van Microsoft Entra-object-id's naar User Principal Names. Als deze parameter niet wordt opgegeven, worden de waarden geretourneerd als Microsoft Entra-object-id's. Houd er rekening mee dat groeps- en toepassingsobject-id's niet worden vertaald omdat ze geen unieke beschrijvende namen hebben.

Type:SwitchParameter
Aliassen:UserPrincipalName
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Het pad in het opgegeven bestandssysteem dat moet worden opgehaald. Moet een map zijn, in de indeling 'directory1/directory2/'.

Type:String
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Recurse

Hiermee wordt aangegeven of het onderliggende item recursief wordt ontvangen. De standaardwaarde is onwaar.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Uitvoerwaarden