New-AzureRmDataLakeStoreItem

NAME New-AzureRmDataLakeStoreItem



SYNOPSIS

Creates a new file or folder in Data Lake Store.





SYNTAX

New-AzureRmDataLakeStoreItem [-Account] <String> [-Path] <DataLakeStorePathInstance> [[-Value] <Object>] [[-Encoding]

<FileSystemCmdletProviderEncoding>] [[-Folder]] [[-Force]] [-DefaultProfile <IAzureContextContainer>] [-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

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





PARAMETERS

-Account <String>

Specifies the name of the Data Lake Store account.



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-DefaultProfile <IAzureContextContainer>

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



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Encoding <FileSystemCmdletProviderEncoding>

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



Required? false

Position? 3

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Folder [<SwitchParameter>]

Indicates that this operation creates a folder.



Required? false

Position? 3

Default value False

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Force [<SwitchParameter>]

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



Required? false

Position? 4

Default value False

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Path <DataLakeStorePathInstance>

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



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Value <Object>

Specifies the content to add to the item you create.



Required? false

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName, ByValue)

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

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



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

Object

Parameter 'Value' accepts value of type 'Object' from the pipeline





OUTPUTS

string

The full path to the created file or folder.





NOTES









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.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... estoreitem

Get-AzureRmDataLakeStoreItem

Export-AzureRmDataLakeStoreItem

Import-AzureRmDataLakeStoreItem

New-AzureRmDataLakeStoreItem

Remove-AzureRmDataLakeStoreItem

Test-AzureRmDataLakeStoreItem