Get-AzDataLakeGen2ChildItem

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

Get-AzDataLakeGen2ChildItem cmdlet 列出 Azure 存储帐户中目录或文件系统中的子目录和文件。 仅当为存储帐户启用了分层命名空间时，此 cmdlet 才有效。 可以使用“-EnableHierarchicalNamespace $true”运行“New-AzStorageAccount”cmdlet 来创建此类帐户。

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

此命令列出文件系统中的直接子项

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

此命令列出文件系统中的直接子项

$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"

此示例使用 MaxCount 和 ContinuationToken 参数以递归方式从多个批处理中的文件系统列出项。 小型 MaxCount 可以限制单个请求返回的项数，可能有助于防止作超时错误，并减少 PowerShell 的内存使用率。 前四个命令将值分配给在示例中要使用的变量。 第五个命令指定 Do-While 语句，该语句使用 Get-AzDataLakeGen2ChildItem cmdlet 列出项。 该语句包括存储在$Token变量中的延续标记。 $Token循环运行时更改值。 最后一个命令使用 Echo 命令显示总计。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。