Remove-​Azure​Rm​Data​Lake​Store​Item​Acl​Entry

Removes an entry from the ACL of a file or folder in Data Lake Store.

Syntax

Remove-AzureRmDataLakeStoreItemAclEntry
      [-Account] <String>
      [-Path] <DataLakeStorePathInstance>
      [-AceType] <AceType>
      [[-Id] <Guid>]
      [-Default]
      [-PassThru]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]
Remove-AzureRmDataLakeStoreItemAclEntry
      [-Account] <String>
      [-Path] <DataLakeStorePathInstance>
      [-Acl] <DataLakeStoreItemAce[]>
      [-PassThru]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Description

The Remove-AzureRmDataLakeStoreItemAclEntry cmdlet removes an entry (ACE) from the access control list (ACL) of a file or folder in Data Lake Store.

Examples

Example 1: Remove a user entry

PS C:\>Remove-AzureRmDataLakeStoreItemAclEntry -AccountName "ContosoADL" -Path / -AceType User -Id (Get-AzureRmADUser -Mail "PattiFuller@contoso.com").ObjectId

This command removes the user ACE for Patti Fuller from the ContosoADL account.

Required Parameters

-Account

Specifies the name of the Data Lake Store account.

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

Specifies the type of ACE to remove. The acceptable values for this parameter are:- User

  • Group
  • Mask
  • Other
Type:AceType
Position:2
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Acl

Specifies the ACL object that contains the entries to be removed.

Type:DataLakeStoreItemAce[]
Position:2
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False
-Path

Specifies the Data Lake Store path of the item from which to remove an ACE, starting with the root directory (/).

Type:DataLakeStorePathInstance
Position:1
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
-Default

Indicates that this operation removes the default ACE from the specified ACL.

Type:SwitchParameter
Position:4
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Id

Specifies the object ID of the AzureActive Directory user, group, or service principal for which to remove an ACE.

Type:Guid
Position:3
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-PassThru

Indicates a boolean response should be returned indicating the result of the delete operation.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
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

Outputs

bool

If PassThru is specified, returns true upon successful completion.