Поделиться через


Get-AzDataLakeGen2ChildItem

Перечисляет вложенные каталоги и файлы из корневого каталога или файловой системы.

Синтаксис

Default (по умолчанию)

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

Описание

Командлет Get-AzDataLakeGen2ChildItem содержит вложенные каталоги и файлы в каталоге или файловой системе в учетной записи хранения Azure. Этот командлет работает только в том случае, если иерархическое пространство имен включено для учетной записи хранения. Эту учетную запись можно создать с помощью командлета New-AzStorageAccount с помощью команды -EnableHierarchicalNamespace $true.

Примеры

Пример 1. Перечисление прямых вложенных элементов из файловой системы

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

Эта команда перечисляет прямые вложенные элементы из файловой системы

Пример 2. Вывод списка рекурсивно из каталога и получение свойств/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

Эта команда перечисляет прямые вложенные элементы из файловой системы

Пример 3. Рекурсивное создание элементов списка из файловой системы в нескольких пакетах

$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 для перечисления элементов. Инструкция включает маркер продолжения, хранящийся в переменной $Token. $Token изменяет значение при выполнении цикла. Последняя команда использует команду Echo для отображения итогового значения.

Параметры

-AsJob

Запуск командлета в фоновом режиме

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Context

Объект контекста службы хранилища Azure

Свойства параметра

Тип:IStorageContext
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ContinuationToken

Токен продолжения.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-FetchProperty

Получение свойств элемента datalake и ACL.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:FetchPermission

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-FileSystem

Имя файловой системы

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MaxCount

Максимальное число больших двоичных объектов, которые могут возвращать.

Свойства параметра

Тип:

Nullable<T>[Int32]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-OutputUserPrincipalName

Если указать этот параметр, значения удостоверений пользователя, возвращаемые в полях владельца и группы каждой записи списка, будут преобразованы из идентификаторов объектов Microsoft Entra в имена субъектов-пользователей. Если этот параметр не указан, значения будут возвращены в виде идентификаторов объектов Microsoft Entra. Обратите внимание, что идентификаторы групп и объектов приложения не преобразуются, так как они не имеют уникальных понятных имен.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ОсновноеИмяПользователя

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Path

Путь в указанной файловой системе, которую необходимо получить. Должен быть каталогом в формате directory1/directory2/.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Recurse

Указывает, будет ли рекурсивно получать дочерний элемент. Значение по умолчанию — false.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

IStorageContext

Выходные данные

AzureDataLakeGen2Item