import Global from '../../_global.mdx';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# pp dataverse table get

Gets a dataverse table in a given environment

## Usage

```sh
m365 pp dataverse table get [options]
```

## Options

```md definition-list
`-e, --environmentName <environmentName>`
: The name of the environment to list a table for.

`-n, --name<name>`
: The name of the dataverse table to retrieve rows from.

`--asAdmin`
: Set, to retrieve the dataverse table as admin for environments you are not a member of.
```

<Global />

## Examples

List a table for the given environment.

```sh
m365 pp dataverse table get --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser"
```

List a table for the given environment as Admin.

```sh
m365 pp dataverse table get --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser" --asAdmin
```

## Response

<Tabs>
  <TabItem value="JSON">

  ```json
  {
    "MetadataId": "84f4c125-474d-ed11-bba1-000d3a2caf7f",
    "IsCustomEntity": true,
    "IsManaged": false,
    "SchemaName": "aaduser",
    "IconVectorName": null,
    "LogicalName": "aaduser",
    "EntitySetName": "aadusers",
    "IsActivity": false,
    "DataProviderId": null,
    "IsRenameable": {
      "Value": true,
      "CanBeChanged": true,
      "ManagedPropertyLogicalName": "isrenameable"
    },
    "IsCustomizable": {
      "Value": true,
      "CanBeChanged": true,
      "ManagedPropertyLogicalName": "iscustomizable"
    },
    "CanCreateForms": {
      "Value": true,
      "CanBeChanged": true,
      "ManagedPropertyLogicalName": "cancreateforms"
    },
    "CanCreateViews": {
      "Value": true,
      "CanBeChanged": true,
      "ManagedPropertyLogicalName": "cancreateviews"
    },
    "CanCreateCharts": {
      "Value": true,
      "CanBeChanged": true,
      "ManagedPropertyLogicalName": "cancreatecharts"
    },
    "CanCreateAttributes": {
      "Value": true,
      "CanBeChanged": false,
      "ManagedPropertyLogicalName": "cancreateattributes"
    },
    "CanChangeTrackingBeEnabled": {
      "Value": true,
      "CanBeChanged": true,
      "ManagedPropertyLogicalName": "canchangetrackingbeenabled"
    },
    "CanModifyAdditionalSettings": {
      "Value": true,
      "CanBeChanged": true,
      "ManagedPropertyLogicalName": "canmodifyadditionalsettings"
    },
    "CanChangeHierarchicalRelationship": {
      "Value": true,
      "CanBeChanged": true,
      "ManagedPropertyLogicalName": "canchangehierarchicalrelationship"
    },
    "CanEnableSyncToExternalSearchIndex": {
      "Value": true,
      "CanBeChanged": true,
      "ManagedPropertyLogicalName": "canenablesynctoexternalsearchindex"
    }
  }
  ```

  </TabItem>
  <TabItem value="Text">

  ```text
  CanChangeHierarchicalRelationship : {"Value":true,"CanBeChanged":true,"ManagedPropertyLogicalName":"canchangehierarchicalrelationship"}
  CanChangeTrackingBeEnabled        : {"Value":true,"CanBeChanged":true,"ManagedPropertyLogicalName":"canchangetrackingbeenabled"}
  CanCreateAttributes               : {"Value":true,"CanBeChanged":false,"ManagedPropertyLogicalName":"cancreateattributes"}
  CanCreateCharts                   : {"Value":true,"CanBeChanged":true,"ManagedPropertyLogicalName":"cancreatecharts"}
  CanCreateForms                    : {"Value":true,"CanBeChanged":true,"ManagedPropertyLogicalName":"cancreateforms"}
  CanCreateViews                    : {"Value":true,"CanBeChanged":true,"ManagedPropertyLogicalName":"cancreateviews"}
  CanEnableSyncToExternalSearchIndex: {"Value":true,"CanBeChanged":true,"ManagedPropertyLogicalName":"canenablesynctoexternalsearchindex"}
  CanModifyAdditionalSettings       : {"Value":true,"CanBeChanged":true,"ManagedPropertyLogicalName":"canmodifyadditionalsettings"}
  DataProviderId                    : null
  EntitySetName                     : aadusers
  IconVectorName                    : null
  IsActivity                        : false
  IsCustomEntity                    : true
  IsCustomizable                    : {"Value":true,"CanBeChanged":true,"ManagedPropertyLogicalName":"iscustomizable"}
  IsManaged                         : false
  IsRenameable                      : {"Value":true,"CanBeChanged":true,"ManagedPropertyLogicalName":"isrenameable"}
  LogicalName                       : aaduser
  MetadataId                        : 84f4c125-474d-ed11-bba1-000d3a2caf7f
  SchemaName                        : aaduser
  ```

  </TabItem>
  <TabItem value="CSV">

  ```csv
  SchemaName,EntitySetName,LogicalName,IsManaged
  aaduser,aadusers,aaduser,false
  ```

  </TabItem>
  <TabItem value="Markdown">

  ```md
  # pp dataverse table get --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser"

  Date: 9/1/2023

  Property | Value
  ---------|-------
  MetadataId | "84f4c125-474d-ed11-bba1-000d3a2caf7f
  IsCustomEntity | true
  IsManaged | false
  SchemaName | aaduser
  IconVectorName | null
  LogicalName | aaduser
  EntitySetName | aadusers
  IsActivity | false
  DataProviderId | null
  ```

  </TabItem>
</Tabs>
