次の方法で共有

New-AzDataLakeGen2Item

  • リファレンス
モジュール:
Az.Storage

ファイル システムにファイルまたはディレクトリを作成します。

構文

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

説明

New-AzDataLakeGen2Item コマンドレットは、Azure ストレージ アカウントのファイルシステムにファイルまたはディレクトリを作成します。 このコマンドレットは、ストレージ アカウントに対して階層型名前空間が有効になっている場合にのみ機能します。 この種類のアカウントは、"-EnableHierarchicalNamespace $true" を使用して "New-AzStorageAccount" コマンドレットを実行することで作成できます。

例

例 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
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ConcurrentTaskCount

同時実行非同期タスクの合計量。 既定値は 10 です。

型:Nullable<T>[Int32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Context

Azure Storage Context オブジェクト

型:IStorageContext
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Directory

この新しい項目がファイルではなくディレクトリであることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EncryptionContext

ファイルの暗号化コンテキスト。 暗号化コンテキストは、ファイルに格納されるときに暗号化されないメタデータです。 このフィールドの主な用途は、暗号化されていないデータを格納することです。このデータを使用して、ファイルの顧客指定のキーを派生させることができます。 ディレクトリには適用されません。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FileSystem

FileSystem 名

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Force

渡された場合、プロンプトなしで新しい項目が作成されます

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Metadata

作成されたディレクトリまたはファイルのメタデータを指定します。

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Path

作成する必要がある指定されたファイルシステム内のパス。 'directory/file.txt' または 'directory1/directory2/' の形式のファイルまたはディレクトリを指定できます。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Permission

ファイル所有者、ファイル所有グループなどの POSIX アクセス許可を設定します。 各クラスには、読み取り、書き込み、または実行のアクセス許可を付与できます。 シンボリック (rwxrw-rw-) がサポートされています。 スティッキー ビットもサポートされ、他のカテゴリの実行ビットがそれぞれ設定されているか未設定であるかに応じて、最後の文字位置の文字 t または T で表されます。t または T がない場合は、スティッキー ビットが設定されていないことを示します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Property

作成されたディレクトリまたはファイルのプロパティを指定します。 ファイルでサポートされているプロパティは、CacheControl、ContentDisposition、ContentEncoding、ContentLanguage、ContentMD5、ContentType です。 ディレクトリでサポートされているプロパティは、CacheControl、ContentDisposition、ContentEncoding、ContentLanguage です。

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Source

Datalake Gen2 ファイルにアップロードするローカル ソース ファイルのパスを指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Umask

新しい項目を作成し、親ディレクトリに既定の ACL がない場合、umask は作成するファイルまたはディレクトリのアクセス許可を制限します。 結果のアクセス許可は p & ^u によって与えられます。ここで、p はアクセス許可であり、umask です。 シンボリック (rwxrw-rw-) がサポートされています。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

IStorageContext

出力

AzureDataLakeGen2Item