Edit

Share via

Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry

  • Reference
Module:
AzureRM.DataLakeAnalytics

Gets an entry in the ACL of a catalog or catalog item in Data Lake Analytics.

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

Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry
   [-Account] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry
   [-Account] <String>
   [-UserOwner]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry
   [-Account] <String>
   [-GroupOwner]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry
   [-Account] <String>
   -ItemType <String>
   -Path <CatalogPathInstance>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry
   [-Account] <String>
   [-UserOwner]
   -ItemType <String>
   -Path <CatalogPathInstance>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry
   [-Account] <String>
   [-GroupOwner]
   -ItemType <String>
   -Path <CatalogPathInstance>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

The Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry cmdlet gets a list of entries (ACEs) in the access control list (ACL) of a catalog or catalog item in Data Lake Analytics.

Examples

Example 1: Get the ACL for a catalog

PS C:\> Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry -Account "contosoadla"

Type  Id                                   Permissions
----  --                                   -----------
User  90a6f74b-fd73-490e-900a-c4f0f9694d02        Read
Group 902b155a-5601-4ca8-8178-ad3289211f88   ReadWrite
Other 00000000-0000-0000-0000-000000000000        None

This command gets the ACL for the catalog of the specified Data Lake Analytics account

Example 2: Get the ACL entry of user owner for a catalog

PS C:\> Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry -Account "contosoadla" -UserOwner

Type      Id                                   Permissions
----      --                                   -----------
UserOwner 0316ac75-6703-4ace-984f-a4dd79aeeafc   ReadWrite

This command gets ACL entry of the user owner for the catalog of the specified Data Lake Analytics account

Example 3: Get the ACL entry of group owner for a catalog

PS C:\> Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry -Account "contosoadla" -GroupOwner

Type       Id                                   Permissions
----       --                                   -----------
GroupOwner 0316ac75-6703-4ace-984f-a4dd79aeeafc   ReadWrite

This command gets ACL entry of the group owner for the catalog of the specified Data Lake Analytics account

Example 4: Get the ACL for a database

PS C:\> Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry -Account "contosoadla" -ItemType Database -Path "databaseName"

Type  Id                                   Permissions
----  --                                   -----------
User  90a6f74b-fd73-490e-900a-c4f0f9694d02        Read
Group 902b155a-5601-4ca8-8178-ad3289211f88   ReadWrite
Other 00000000-0000-0000-0000-000000000000        None

This command gets the ACL for the database of the specified Data Lake Analytics account

Example 5: Get the ACL entry of user owner for a database

PS C:\> Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry -Account "contosoadla" -UserOwner -ItemType Database -Path "databaseName"

Type      Id                                   Permissions
----      --                                   -----------
UserOwner 0316ac75-6703-4ace-984f-a4dd79aeeafc   ReadWrite

This command gets the ACL entry of the user owner for the database of the specified Data Lake Analytics account

Example 6: Get the ACL entry of group owner for a database

PS C:\> Get-AzureRmDataLakeAnalyticsCatalogItemAclEntry -Account "contosoadla" -GroupOwner -ItemType Database -Path "databaseName"

Type       Id                                   Permissions
----       --                                   -----------
GroupOwner 0316ac75-6703-4ace-984f-a4dd79aeeafc   ReadWrite

This command gets the ACL entry of the group owner for the database of the specified Data Lake Analytics account

Parameters

-Account

Specifies the Data Lake Analytics account name.

Type:String
Aliases:AccountName
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

-GroupOwner

Get ACL entry of catalog for group owner

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

-ItemType

Specifies the type of the catalog or catalog item(s). The acceptable values for this parameter are:

  • Catalog
  • Database
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Specifies the Data Lake Analytics path of an catalog or catalog item. The parts of the path should be separated by a period (.).

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

-UserOwner

Get ACL entry of catalog for user owner.

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

Inputs

String

CatalogPathInstance

Outputs

PSDataLakeAnalyticsAcl