New-AzDataLakeGen2Item

Syntax

File (Default)

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>]

Description

Examples

Example 1: Create a directory with specified permission, Umask, properties, and metadata

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

Example 2: Create(upload) a data lake file from a local source file, and the cmdlet runs in background

$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

Example 3: Create(upload) a data lake file from a local source file and set its encryption context

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

encryptioncontext

Parameters

-AsJob

Run cmdlet in the background

Parameter properties

Parameter sets

-ConcurrentTaskCount

The total amount of concurrent async tasks. The default value is 10.

Parameter properties

Parameter sets

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Parameter sets

-Context

Azure Storage Context Object

Parameter properties

Parameter sets

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Parameter properties

Parameter sets

-Directory

Indicates that this new item is a directory and not a file.

Parameter properties

Parameter sets

-EncryptionContext

Encryption context of the file. Encryption context is metadata that is not encrypted when stored on the file. The primary application of this field is to store non-encrypted data that can be used to derive the customer-provided key for a file. Not applicable for directories.

Parameter properties

Parameter sets

-FileSystem

FileSystem name

Parameter properties

Parameter sets

-Force

If passed then new item is created without any prompt

Parameter properties

Parameter sets

-Metadata

Specifies metadata for the created directory or file.

Parameter properties

Parameter sets

-Path

The path in the specified Filesystem that should be create. Can be a file or directory In the format 'directory/file.txt' or 'directory1/directory2/'

Parameter properties

Parameter sets

-Permission

Sets POSIX access permissions for the file owner, the file owning group, and others. Each class may be granted read, write, or execute permission. Symbolic (rwxrw-rw-) is supported. The sticky bit is also supported and its represented either by the letter t or T in the final character-place depending on whether the execution bit for the others category is set or unset respectively, absence of t or T indicates sticky bit not set.

Parameter properties

Parameter sets

-Property

Specifies properties for the created directory or file. The supported properties for file are: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType. The supported properties for directory are: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage.

Parameter properties

Parameter sets

-Source

Specify the local source file path which will be upload to a Datalake Gen2 file.

Parameter properties

Parameter sets

-Umask

When creating New Item and the parent directory does not have a default ACL, the umask restricts the permissions of the file or directory to be created. The resulting permission is given by p & ^u, where p is the permission and u is the umask. Symbolic (rwxrw-rw-) is supported.

Parameter properties

Parameter sets

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Parameter sets

CommonParameters

Inputs

String

IStorageContext

Outputs

AzureDataLakeGen2Item