Get-AzDataLakeGen2ChildItem

Ссылка

Модуль:: Az.Storage

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

Синтаксис

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

Параметры

-AsJob

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Context

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

Тип:	IStorageContext
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-ContinuationToken

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultProfile

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

Тип:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FetchProperty

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

Тип:	SwitchParameter
Aliases:	FetchPermission
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FileSystem

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

Тип:	String
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-MaxCount

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

Тип:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OutputUserPrincipalName

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

Тип:	SwitchParameter
Aliases:	UserPrincipalName
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Path

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

Тип:	String
Position:	1
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Recurse

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

String

IStorageContext

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

AzureDataLakeGen2Item

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