New-AzDataLakeGen2Item

참조

모듈:: Az.Storage

파일 시스템에 파일 또는 디렉터리를 만듭니다.

Syntax

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

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

New-AzDataLakeGen2Item cmdlet은 Azure Storage 계정의 Filesystem에 파일 또는 디렉터리를 만듭니다. 이 cmdlet은 스토리지 계정에 대해 계층 구조 네임스페이스를 사용하는 경우에만 작동합니다. 이러한 종류의 계정은 "-EnableHierarchicalNamespace $true"가 있는 "New-AzStorageAccount" cmdlet을 실행하여 만들 수 있습니다.

예제

예제 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

이 명령은 지정된 Permission, Umask, 속성 및 메타데이터를 사용하여 디렉터리를 만듭니다.

예제 2: 로컬 원본 파일에서 데이터 레이크 파일을 만들고(업로드) cmdlet이 백그라운드에서 실행됩니다.

$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

이 명령은 로컬 소스 파일에서 데이터 레이크 파일을 만들고(업로드) cmdlet이 백그라운드에서 실행됩니다.

예제 3: 로컬 원본 파일에서 데이터 레이크 파일 만들기(업로드) 및 해당 암호화 컨텍스트 설정

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

encryptioncontext

이 명령은 로컬 원본 파일에서 데이터 레이크 파일을 만들고 암호화 컨텍스트 값을 "encryptioncontext"로 설정합니다.

매개 변수

-AsJob

백그라운드에서 cmdlet 실행

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConcurrentTaskCount

동시 비동기 작업의 총 크기입니다. 기본값은 10입니다.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Context

Azure Storage 컨텍스트 개체

Type:	IStorageContext
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Directory

이 새 항목이 파일이 아닌 디렉터리임을 나타냅니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionContext

파일의 암호화 컨텍스트입니다. 암호화 컨텍스트는 파일에 저장할 때 암호화되지 않은 메타데이터입니다. 이 필드의 기본 애플리케이션은 파일에 대해 고객이 제공한 키를 파생시키는 데 사용할 수 있는 암호화되지 않은 데이터를 저장하는 것입니다. 디렉터리에는 적용되지 않습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FileSystem

FileSystem 이름

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

전달되면 프롬프트 없이 새 항목이 만들어집니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Metadata

만든 디렉터리 또는 파일에 대한 메타데이터를 지정합니다.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

만들어야 하는 지정된 파일 시스템의 경로입니다. 'directory/file.txt' 또는 'directory1/directory2/' 형식의 파일 또는 디렉터리일 수 있습니다.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Permission

파일 소유자, 파일 소유 그룹 등에 대한 POSIX 액세스 권한을 설정합니다. 각 클래스에는 읽기, 쓰기 또는 실행 권한이 부여될 수 있습니다. 기호(rwxrw-rw-)가 지원됩니다. 고정 비트도 지원되며 다른 범주의 실행 비트가 각각 설정되었는지 여부에 따라 최종 문자 위치의 t 또는 T로 표현되며 t 또는 T가 없는 경우 고정 비트가 설정되지 않음을 나타냅니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Property

만든 디렉터리 또는 파일에 대한 속성을 지정합니다. 파일에 지원되는 속성은 CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType입니다. 디렉터리에 지원되는 속성은 CacheControl, ContentDisposition, ContentEncoding, ContentLanguage입니다.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Source

Datalake Gen2 파일에 업로드할 로컬 원본 파일 경로를 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Umask

새 항목을 만들고 부모 디렉터리에 기본 ACL이 없는 경우 umask는 만들 파일 또는 디렉터리의 권한을 제한합니다. 결과 권한은 p &^u에서 부여됩니다. 여기서 p는 사용 권한이며 umask입니다. 기호(rwxrw-rw-)가 지원됩니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

입력

String

IStorageContext

출력

AzureDataLakeGen2Item