New-AzDataLakeGen2Item

Odwołanie

Moduł:: Az.Storage

Utwórz plik lub katalog w systemie plików.

Składnia

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

Opis

Polecenie cmdlet New-AzDataLakeGen2Item tworzy plik lub katalog w systemie plików na koncie usługi Azure Storage. To polecenie cmdlet działa tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta magazynu. Tego rodzaju konto można utworzyć za pomocą polecenia cmdlet "New-AzStorageAccount" za pomocą polecenia "-EnableHierarchicalNamespace $true".

Przykłady

Przykład 1: Tworzenie katalogu z określonym uprawnieniem, maską Umask, właściwościami i metadanymi

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

To polecenie tworzy katalog z określonym uprawnieniem, maską Umask, właściwościami i metadanymi

Przykład 2: Tworzenie(przekazywanie) pliku typu data lake z lokalnego pliku źródłowego, a polecenie cmdlet jest uruchamiane w tle

$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

To polecenie tworzy (przekaż) plik data lake z lokalnego pliku źródłowego, a polecenie cmdlet jest uruchamiane w tle.

Przykład 3. Tworzenie (przekazywanie) pliku typu data lake z lokalnego pliku źródłowego i ustawianie kontekstu szyfrowania

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

encryptioncontext

To polecenie tworzy (przekazywanie) pliku data lake z lokalnego pliku źródłowego i ustawia jego wartość kontekstu szyfrowania na "encryptioncontext".

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ConcurrentTaskCount

Całkowita ilość współbieżnych zadań asynchronicznych. Wartość domyślna to 10.

Typ:	Nullable<T>[Int32]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Context

Obiekt kontekstu usługi Azure Storage

Typ:	IStorageContext
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:	IAzureContextContainer
Aliasy:	AzureRmContext, AzureCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Directory

Wskazuje, że ten nowy element jest katalogiem, a nie plikiem.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-EncryptionContext

Kontekst szyfrowania pliku. Kontekst szyfrowania to metadane, które nie są szyfrowane podczas przechowywania w pliku. Podstawową aplikacją tego pola jest przechowywanie nieszyfrowanych danych, których można użyć do uzyskania klucza dostarczonego przez klienta dla pliku. Nie dotyczy katalogów.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-FileSystem

Nazwa systemu plików

Typ:	String
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Force

Jeśli przekazano, nowy element zostanie utworzony bez monitu

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Metadata

Określa metadane utworzonego katalogu lub pliku.

Typ:	Hashtable
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Path

Ścieżka w określonym systemie plików, który ma zostać utworzony. Może być plikiem lub katalogiem w formacie "directory/file.txt" lub "directory1/directory2/"

Typ:	String
Position:	1
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Permission

Ustawia uprawnienia dostępu POSIX dla właściciela pliku, grupy właścicieli plików i innych. Każda klasa może mieć uprawnienie do odczytu, zapisu lub wykonywania. Obsługiwane są symbole (rwxrw-rw-). Bit lepki jest również obsługiwany, a jego reprezentacja przez literę t lub T w końcowym miejscu znaku w zależności od tego, czy bit wykonywania dla innej kategorii jest ustawiony, czy nie ustawiono odpowiednio, brak t lub T wskazuje lepki bit nie ustawiono.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Property

Określa właściwości utworzonego katalogu lub pliku. Obsługiwane właściwości pliku to: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType. Obsługiwane właściwości katalogu to: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage.

Typ:	Hashtable
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Source

Określ lokalną ścieżkę pliku źródłowego, która zostanie przekazana do pliku usługi Datalake Gen2.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Umask

Podczas tworzenia nowego elementu i katalogu nadrzędnego nie ma domyślnej listy ACL, maska umask ogranicza uprawnienia do tworzenia pliku lub katalogu. Wynikowe uprawnienie jest podane przez p & ^u, gdzie p jest uprawnieniem i jesteś maską umask. Obsługiwane są symbole (rwxrw-rw-).

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

String

IStorageContext

Dane wyjściowe

AzureDataLakeGen2Item

Udostępnij za pośrednictwem