Remove-​Azure​Batch​Node​File

Deletes a node file for a task or compute node.

Syntax

Remove-AzureBatchNodeFile
      [-PoolId] <String>
      [-ComputeNodeId] <String>
      -BatchContext <BatchAccountContext>
      [-Force]
      -Name <String>
      [-Recursive]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]
Remove-AzureBatchNodeFile
      [[-InputObject] <PSNodeFile>]
      -BatchContext <BatchAccountContext>
      [-Force]
      [-Recursive]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]
Remove-AzureBatchNodeFile
      -BatchContext <BatchAccountContext>
      [-Force]
      -JobId <String>
      -Name <String>
      [-Recursive]
      -TaskId <String>
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Description

The Remove-AzureBatchNodeFile cmdlet deletes an Azure Batch node file for a task or compute node.

Examples

Example 1: Delete a file assocated with a task

PS C:\>Remove-AzureBatchNodeFile -JobId "Job-000001" -TaskId "Task26" -Name "wd\testFile.txt" -BatchContext $Context

This command deletes the node file that is named wd\testFile.txt. That file is associated with the task that has the ID Task26 under the job Job-000001.

Example 2: Delete a file from a compute node

PS C:\>Remove-AzureBatchNodeFile -PoolId "Pool07" -ComputeNodeId "tvm-2316545714_1-20150725t213220z" -Name "startup\testFile.txt" -BatchContext $Context

This command deletes the node file that is named startup\testFile.txt from the specified compute node in the pool that has the ID Pool07.

Example 3: Remove a file by using the pipeline

PS C:\>Get-AzureBatchNodeFile -JobId "Job-000001" -TaskId "Task26" -Name "wd\testFile2.txt" -BatchContext $Context | Remove-AzureBatchNodeFile -Force -BatchContext $Context

This command gets the node file by using Get-AzureBatchNodeFile. That file is associated with the task that has the ID Task26 under the job Job-000001. The command passes that file to the current cmdlet by using the pipeline. The current cmdlet removes the node file. The command specifies the Force parameter. Therefore, the command does not prompt you for confirmation.

Required Parameters

-BatchContext

Specifies the BatchAccountContext instance that this cmdlet uses to interact with the Batch service. To obtain a BatchAccountContext object that contains access keys for your subscription, use the Get-AzureRmBatchAccountKeys cmdlet.

Type:BatchAccountContext
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-ComputeNodeId

Specifies the ID of the compute node that contains the Batch node file that this cmdlet deletes.

Type:String
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-JobId

Specifies the ID of the job that contains the task.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Name

Specifies the name of the node file that this cmdlet deletes.

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

Specifies the ID of the pool that contains the compute nodes for which this cmdlet removes a file.

Type:String
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-TaskId

Specifies the ID of the task.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

Forces the command to run without asking for user confirmation.

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

Specifies PSNodeFile object that represent the node file that this cmdlet deletes. To obtain a PSNodeFile, use the Get-AzureBatchNodeFile cmdlet.

Type:PSNodeFile
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Recursive

Indicates that this cmdlet deletes the folder and all subfolders and files under the specified path. This cmdlet is relevant only if the path is a folder.

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