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


New-AzDataLakeGen2Item

Создайте файл или каталог в файловой системе.

Синтаксис

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

New-AzDataLakeGen2Item
    [-FileSystem] <String>
    [-Path] <String>
    -Source <String>
    [-Umask <String>]
    [-Permission <String>]
    [-EncryptionContext <String>]
    [-Property <Hashtable>]
    [-Metadata <Hashtable>]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Directory

New-AzDataLakeGen2Item
    [-FileSystem] <String>
    [-Path] <String>
    [-Directory]
    [-Umask <String>]
    [-Permission <String>]
    [-Property <Hashtable>]
    [-Metadata <Hashtable>]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

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

Примеры

Пример 1. Создание каталога с указанным разрешением, Umask, свойствами и метаданными

New-AzDataLakeGen2Item -FileSystem "testfilesystem" -Path "dir1/dir2/" -Directory -Permission rwxrwxrwT -Umask ---rw---- -Property @{"CacheControl" = "READ"; "ContentDisposition" = "True"} -Metadata  @{"tag1" = "value1"; "tag2" = "value2" }
FileSystem Name: filesystem1

Path                 IsDirectory  Length          LastModified         Permissions  Owner                Group
----                 -----------  ------          ------------         -----------  -----                -----
dir1/dir2            True                         2020-03-23 09:15:56Z rwx---rwT    $superuser           $superuser

Эта команда создает каталог с указанным разрешением, Umask, свойствами и метаданными

Пример 2. Создание (отправка) файла озера данных из локального исходного файла, а командлет выполняется в фоновом режиме.

$task = New-AzDataLakeGen2Item  -FileSystem "testfilesystem" -Path "dir1/dir2/file1" -Source "c:\sourcefile.txt" -Force -asjob
$task | Wait-Job
$task.Output
FileSystem Name: filesystem1

Path                 IsDirectory  Length          LastModified         Permissions  Owner                Group
----                 -----------  ------          ------------         -----------  -----                -----
dir1/dir2/file1      False        14400000        2020-03-23 09:19:13Z rw-r-----    $superuser           $superuser

Эта команда создает (отправить) файл озера данных из локального исходного файла, а командлет выполняется в фоновом режиме.

Пример 3. Создание (отправка) файла озера данных из локального исходного файла и настройка контекста шифрования

$file = New-AzDataLakeGen2Item -FileSystem "testfilesystem" -Path "dir1/dir2/file1" -Source "c:\sourcefile.txt" -EncryptionContext "encryptioncontext"
$file.Properties.EncryptionContext
encryptioncontext

Эта команда создает (отправить) файл озера данных из локального исходного файла и задает для него значение контекста шифрования "encryptioncontext".

Параметры

-AsJob

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

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

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

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

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

-ConcurrentTaskCount

Общий объем параллельных асинхронных задач. Значение по умолчанию — 10.

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

Тип:

Nullable<T>[Int32]

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

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

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

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

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

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

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

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

-Context

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

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

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

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

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

-DefaultProfile

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

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

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

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

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

-Directory

Указывает, что этот новый элемент является каталогом, а не файлом.

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

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

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

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

-EncryptionContext

Контекст шифрования файла. Контекст шифрования — это метаданные, которые не шифруются при хранении в файле. Основное приложение этого поля заключается в хранении нешифрованных данных, которые можно использовать для получения ключа, предоставленного клиентом для файла. Неприменимо для каталогов.

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

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

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

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

-FileSystem

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

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

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

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

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

-Force

При передаче новый элемент создается без запроса

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

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

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

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

-Metadata

Задает метаданные для созданного каталога или файла.

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

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

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

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

-Path

Путь в указанной файловой системе, который должен быть создан. Может быть файлом или каталогом в формате "directory/file.txt" или "directory1/directory2/"

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

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

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

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

-Permission

Задает разрешения доступа POSIX для владельца файла, группы владельцев файлов и других пользователей. Каждому классу может быть предоставлено разрешение на чтение, запись или выполнение. Поддерживается символьная (rwxrw-rw-). Липкий бит также поддерживается и его представлен буквой t или T в последнем месте символа в зависимости от того, установлен ли бит выполнения для другой категории или не задан соответственно, отсутствие t или T указывает, что липкий бит не задан.

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

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

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

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

-Property

Задает свойства для созданного каталога или файла. Поддерживаемые свойства для файла: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType. Поддерживаемые свойства каталога: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage.

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

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

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

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

-Source

Укажите путь к локальному исходному файлу, который будет отправлен в файл Datalake 2-го поколения.

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

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

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

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

-Umask

При создании нового элемента и родительского каталога не имеет ACL по умолчанию, umask ограничивает разрешения создаваемого файла или каталога. Полученное разрешение предоставляется p & ^u, где p — это разрешение, и вы — umask. Поддерживается символьная (rwxrw-rw-).

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

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

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

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

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

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

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

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

(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