New-AzureRmDataLakeStoreItem

Reference

Module:: AzureRM.DataLakeStore

Creates a new file or folder in Data Lake Store.

Warning

The AzureRM PowerShell module has been officially deprecated as of February 29, 2024. Users are advised to migrate from AzureRM to the Az PowerShell module to ensure continued support and updates.

Although the AzureRM module may still function, it's no longer maintained or supported, placing any continued use at the user's discretion and risk. Please refer to our migration resources for guidance on transitioning to the Az module.

Syntax

New-AzureRmDataLakeStoreItem
   [-Account] <String>
   [-Path] <DataLakeStorePathInstance>
   [[-Value] <Object>]
   [[-Encoding] <FileSystemCmdletProviderEncoding>]
   [-Folder]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-AzureRmDataLakeStoreItem cmdlet creates a new file or folder in Data Lake Store.

Examples

Example 1: Create a new file and a new folder

PS C:\>New-AzureRmDataLakeStoreItem -AccountName "ContosoADL" -Path "/NewFile.txt"
PS C:\> New-AzureRmDataLakeStoreItem -AccountName "ContosoADL" -Path "/NewFolder" -Folder

The first command creates the file NewFile.txt for the specified account. The second command creates the folder NewFolder at the root folder.

Parameters

-Account

Specifies the name of the Data Lake Store account.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with azure.

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

-Encoding

Specifies the encoding for the item to create. The acceptable values for this parameter are:

Unknown
String
Unicode
Byte
BigEndianUnicode
UTF8
UTF7
Ascii
Default
Oem
BigEndianUTF32

Type:	FileSystemCmdletProviderEncoding
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Folder

Indicates that this operation creates a folder.

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

-Force

Indicates that this operation can overwrite the destination item if it already exists.

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

-Path

Specifies the Data Lake Store path of the item to create, starting with the root directory (/).

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

-Value

Specifies the content to add to the item you create.

Type:	Object
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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

Inputs

String

DataLakeStorePathInstance

Object

FileSystemCmdletProviderEncoding

SwitchParameter

Outputs