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

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

-ConcurrentTaskCount

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

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Context

Obiekt kontekstu usługi Azure Storage

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

-DefaultProfile

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

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

-Directory

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-FileSystem

Nazwa systemu plików

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

-Force

Jeśli przekazano, nowy element zostanie utworzony bez monitu

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

-Metadata

Określa metadane utworzonego katalogu lub pliku.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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/"

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-Source

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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-).

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

-WhatIf

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

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

Dane wejściowe

String

IStorageContext

Dane wyjściowe

AzureDataLakeGen2Item