Get-AzDataLakeGen2ChildItem

  • Referentie
Module:
Az.Storage

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

Syntax

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

Description

De cmdlet Get-AzDataLakeGen2ChildItem 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 requst, 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. Met de vijfde opdracht geeft u een Do-While-instructie op die gebruikmaakt van de cmdlet Get-AzDataLakeGen2ChildItem 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 echo-opdracht om het totaal weer te geven.

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Azure Storage-contextobject

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ContinuationToken

Vervolgtoken.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FetchProperty

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

Type:SwitchParameter
Aliases:FetchPermission
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileSystem

Bestandsnaam

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxCount

Het maximumaantal blobs dat kan worden geretourneerd.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:UserPrincipalName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Recurse

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

IStorageContext

Uitvoerwaarden

AzureDataLakeGen2Item