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 記憶體帳戶的文件系統中建立檔案或目錄。只有當儲存體帳戶啟用階層命名空間時，此 Cmdlet 才有效。您可以使用 “-EnableHierarchicalNamespace $true” 執行 “New-Az 儲存體 Account” 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

此命令會建立具有指定許可權、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 儲存體 Context 物件

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

應建立之指定之 Filesystem 中的路徑。可以是檔案或目錄，格式為 '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