DataGateway.Profile

3000.15.15

Microsoft.DataMovement.Powershell.Commands.DataGateway.Profile.dll-Help.xml

<?xml version="1.0" encoding="utf-8"?>
<helpItems schema="maml" xmlns="http://msh">
  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
    <command:details>
      <command:name>Connect-DataGatewayServiceAccount</command:name>
      <command:verb>Connect</command:verb>
      <command:noun>DataGatewayServiceAccount</command:noun>
      <maml:description>
        <maml:para>Connect to the Data Gateway service.</maml:para>
      </maml:description>
    </command:details>
    <maml:description>
      <maml:para>Connect to the Data Gateway service with a username. For user accounts, an Azure Active Directory (AAD) First-Party application is leveraged for authentication. To log out call Disconnect-DataGatewayServiceAccount.</maml:para>
    </maml:description>
    <command:syntax>
      <command:syntaxItem>
        <maml:name>Connect-DataGatewayServiceAccount</maml:name>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Environment</maml:name>
          <maml:Description>
            <maml:para>Cloud environment to connect against. Default is Public.</maml:para>
          </maml:Description>
          <command:parameterValueGroup>
            <command:parameterValue required="false" command:variableLength="false">Public</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">Germany</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGov</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">China</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGovHigh</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGovMil</command:parameterValue>
          </command:parameterValueGroup>
          <command:parameterValue required="true" variableLength="false">PowerBIEnvironmentType</command:parameterValue>
          <dev:type>
            <maml:name>PowerBIEnvironmentType</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>
    <command:parameters>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>Environment</maml:name>
        <maml:Description>
          <maml:para>Cloud environment to connect against. Default is Public.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">PowerBIEnvironmentType</command:parameterValue>
        <dev:type>
          <maml:name>PowerBIEnvironmentType</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
    </command:parameters>
    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
        </dev:type>
        <maml:description>
          <maml:para></maml:para>
        </maml:description>
      </command:inputType>
    </command:inputTypes>
    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>Microsoft.DataMovement.Powershell.Abstractions.Interfaces.IPowerBIProfile</maml:name>
        </dev:type>
        <maml:description>
          <maml:para></maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>
    <maml:alertSet>
      <maml:alert>
        <maml:para></maml:para>
      </maml:alert>
    </maml:alertSet>
    <command:examples>
      <command:example>
        <maml:title>-------------------------- Example 1 --------------------------</maml:title>
        <dev:code>PS C:\&gt; Connect-DataGatewayServiceAccount</dev:code>
        <dev:remarks>
          <maml:para>Logs in using user authentication against the Public cloud, a prompt will display to collect credentials.</maml:para>
        </dev:remarks>
      </command:example>
      <command:example>
        <maml:title>-------------------------- Example 2 --------------------------</maml:title>
        <dev:code>PS C:\&gt; Connect-DataGatewayServiceAccount -Environment China</dev:code>
        <dev:remarks>
          <maml:para>Logs in using user authentication against the China cloud, a prompt will display to collect credentials.</maml:para>
        </dev:remarks>
      </command:example>
    </command:examples>
    <command:relatedLinks />
  </command:command>
  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
    <command:details>
      <command:name>Disconnect-DataGatewayServiceAccount</command:name>
      <command:verb>Disconnect</command:verb>
      <command:noun>DataGatewayServiceAccount</command:noun>
      <maml:description>
        <maml:para>Disconnect from the Data Gateway service.</maml:para>
      </maml:description>
    </command:details>
    <maml:description>
      <maml:para>Disconnects from any previous Data Gateway Service connections. If there were no connections, the command completes without error.</maml:para>
    </maml:description>
    <command:syntax>
      <command:syntaxItem>
        <maml:name>Disconnect-DataGatewayServiceAccount</maml:name>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Environment</maml:name>
          <maml:Description>
            <maml:para>Cloud environment to use. Default is Public.</maml:para>
          </maml:Description>
          <command:parameterValueGroup>
            <command:parameterValue required="false" command:variableLength="false">Public</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">Germany</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGov</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">China</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGovHigh</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGovMil</command:parameterValue>
          </command:parameterValueGroup>
          <command:parameterValue required="true" variableLength="false">PowerBIEnvironmentType</command:parameterValue>
          <dev:type>
            <maml:name>PowerBIEnvironmentType</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>
    <command:parameters>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>Environment</maml:name>
        <maml:Description>
          <maml:para>Cloud environment to use. Default is Public.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">PowerBIEnvironmentType</command:parameterValue>
        <dev:type>
          <maml:name>PowerBIEnvironmentType</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
    </command:parameters>
    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
        </dev:type>
        <maml:description>
          <maml:para></maml:para>
        </maml:description>
      </command:inputType>
    </command:inputTypes>
    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>System.Void</maml:name>
        </dev:type>
        <maml:description>
          <maml:para></maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>
    <maml:alertSet>
      <maml:alert>
        <maml:para></maml:para>
      </maml:alert>
    </maml:alertSet>
    <command:examples>
      <command:example>
        <maml:title>-------------------------- Example 1 --------------------------</maml:title>
        <dev:code>PS C:\&gt; Disconnect-DataGatewayServiceAccount</dev:code>
        <dev:remarks>
          <maml:para>Disconnects any active Data Gateway service connections.</maml:para>
        </dev:remarks>
      </command:example>
    </command:examples>
    <command:relatedLinks />
  </command:command>
  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
    <command:details>
      <command:name>Get-DataGatewayAccessToken</command:name>
      <command:verb>Get</command:verb>
      <command:noun>DataGatewayAccessToken</command:noun>
      <maml:description>
        <maml:para>Gets the access token for your current Data Gateway authenticated session.</maml:para>
      </maml:description>
    </command:details>
    <maml:description>
      <maml:para>Returns the Data Gateway access token gathered from logged in Data Gateway profile. Before you run this command, make sure you log in using Connect-DataGatewayServiceAccount.</maml:para>
    </maml:description>
    <command:syntax>
      <command:syntaxItem>
        <maml:name>Get-DataGatewayAccessToken</maml:name>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>AsString</maml:name>
          <maml:Description>
            <maml:para>Indicates to return the access token as a string instead of a hashtable. The string contains the authentication type, such as "Bearer".</maml:para>
          </maml:Description>
          <dev:type>
            <maml:name>SwitchParameter</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>False</dev:defaultValue>
        </command:parameter>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Environment</maml:name>
          <maml:Description>
            <maml:para>Cloud environment to use. Default is Public.</maml:para>
          </maml:Description>
          <command:parameterValueGroup>
            <command:parameterValue required="false" command:variableLength="false">Public</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">Germany</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGov</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">China</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGovHigh</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGovMil</command:parameterValue>
          </command:parameterValueGroup>
          <command:parameterValue required="true" variableLength="false">PowerBIEnvironmentType</command:parameterValue>
          <dev:type>
            <maml:name>PowerBIEnvironmentType</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>
    <command:parameters>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>AsString</maml:name>
        <maml:Description>
          <maml:para>Indicates to return the access token as a string instead of a hashtable. The string contains the authentication type, such as "Bearer".</maml:para>
        </maml:Description>
        <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>False</dev:defaultValue>
      </command:parameter>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>Environment</maml:name>
        <maml:Description>
          <maml:para>Cloud environment to use. Default is Public.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">PowerBIEnvironmentType</command:parameterValue>
        <dev:type>
          <maml:name>PowerBIEnvironmentType</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
    </command:parameters>
    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
        </dev:type>
        <maml:description>
          <maml:para></maml:para>
        </maml:description>
      </command:inputType>
    </command:inputTypes>
    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>System.Collections.Hashtable</maml:name>
        </dev:type>
        <maml:description>
          <maml:para></maml:para>
        </maml:description>
      </command:returnValue>
      <command:returnValue>
        <dev:type>
          <maml:name>System.String</maml:name>
        </dev:type>
        <maml:description>
          <maml:para></maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>
    <maml:alertSet>
      <maml:alert>
        <maml:para></maml:para>
      </maml:alert>
    </maml:alertSet>
    <command:examples>
      <command:example>
        <maml:title>-------------------------- Example 1 --------------------------</maml:title>
        <dev:code>PS C:\&gt; $headers = Get-DataGatewayAccessToken
PS C:\&gt; Invoke-RestMethod -Headers $headers -Uri 'https://api.powerbi.com/v1.0/myorg/groups'</dev:code>
        <dev:remarks>
          <maml:para>Gets the Power BI access token as a hashtable and passes it to Invoke-RestMethod, as part of the header, to authenticate.</maml:para>
        </dev:remarks>
      </command:example>
    </command:examples>
    <command:relatedLinks />
  </command:command>
  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
    <command:details>
      <command:name>Invoke-DataGatewayRestMethod</command:name>
      <command:verb>Invoke</command:verb>
      <command:noun>DataGatewayRestMethod</command:noun>
      <maml:description>
        <maml:para>Executes a REST call to the Data Gateway service, with the specified URL and body.</maml:para>
      </maml:description>
    </command:details>
    <maml:description>
      <maml:para>Invokes a REST request against the Data Gateway service using the profile you're logged in with. The REST verb can be specified using the -Method parameter. The -Body parameter is required for the verbs POST, PUT, and PATCH. Before you run this command, make sure you log in using Connect-DataGatewayServiceAccount.</maml:para>
    </maml:description>
    <command:syntax>
      <command:syntaxItem>
        <maml:name>Invoke-DataGatewayRestMethod</maml:name>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Body</maml:name>
          <maml:Description>
            <maml:para>Body of the request, also known as content . This is optional unless the request method is POST, PUT, or PATCH.</maml:para>
          </maml:Description>
          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
          <dev:type>
            <maml:name>String</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>ContentType</maml:name>
          <maml:Description>
            <maml:para>Content type to specify inside the header for the request. Default is 'application/json'.</maml:para>
          </maml:Description>
          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
          <dev:type>
            <maml:name>String</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Environment</maml:name>
          <maml:Description>
            <maml:para>Cloud environment to use. Default is Public.</maml:para>
          </maml:Description>
          <command:parameterValueGroup>
            <command:parameterValue required="false" command:variableLength="false">Public</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">Germany</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGov</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">China</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGovHigh</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGovMil</command:parameterValue>
          </command:parameterValueGroup>
          <command:parameterValue required="true" variableLength="false">PowerBIEnvironmentType</command:parameterValue>
          <dev:type>
            <maml:name>PowerBIEnvironmentType</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Headers</maml:name>
          <maml:Description>
            <maml:para>Optional headers to include with the request.</maml:para>
          </maml:Description>
          <command:parameterValue required="true" variableLength="false">Hashtable</command:parameterValue>
          <dev:type>
            <maml:name>Hashtable</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
        <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Method</maml:name>
          <maml:Description>
            <maml:para>Type of HTTP request method\verb to make with the call.</maml:para>
          </maml:Description>
          <command:parameterValueGroup>
            <command:parameterValue required="false" command:variableLength="false">Get</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">Post</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">Delete</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">Put</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">Patch</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">Options</command:parameterValue>
          </command:parameterValueGroup>
          <command:parameterValue required="true" variableLength="false">DataGatewayWebRequestMethod</command:parameterValue>
          <dev:type>
            <maml:name>DataGatewayWebRequestMethod</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Organization</maml:name>
          <maml:Description>
            <maml:para>Organization name or tenant GUID to include in the URL. Default is 'myorg'.</maml:para>
          </maml:Description>
          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
          <dev:type>
            <maml:name>String</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>OutFile</maml:name>
          <maml:Description>
            <maml:para>Output file for writing the response content to. File path specified must not exist.</maml:para>
          </maml:Description>
          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
          <dev:type>
            <maml:name>String</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
        <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Url</maml:name>
          <maml:Description>
            <maml:para>Relative or absolute URL of the Power BI entity you want to access. For example, if you want to access https://api.powerbi.com/v1.0/myorg/groups, then specify 'groups', or pass in the entire URL.</maml:para>
          </maml:Description>
          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
          <dev:type>
            <maml:name>String</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Version</maml:name>
          <maml:Description>
            <maml:para>Version of the API to include in the URL. Default is 'v1.0'. Ignored if -Url is an absolute URL.</maml:para>
          </maml:Description>
          <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
          <dev:type>
            <maml:name>String</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>
    <command:parameters>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>Body</maml:name>
        <maml:Description>
          <maml:para>Body of the request, also known as content . This is optional unless the request method is POST, PUT, or PATCH.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>ContentType</maml:name>
        <maml:Description>
          <maml:para>Content type to specify inside the header for the request. Default is 'application/json'.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>Environment</maml:name>
        <maml:Description>
          <maml:para>Cloud environment to use. Default is Public.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">PowerBIEnvironmentType</command:parameterValue>
        <dev:type>
          <maml:name>PowerBIEnvironmentType</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>Headers</maml:name>
        <maml:Description>
          <maml:para>Optional headers to include with the request.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">Hashtable</command:parameterValue>
        <dev:type>
          <maml:name>Hashtable</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
      <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>Method</maml:name>
        <maml:Description>
          <maml:para>Type of HTTP request method\verb to make with the call.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">DataGatewayWebRequestMethod</command:parameterValue>
        <dev:type>
          <maml:name>DataGatewayWebRequestMethod</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>Organization</maml:name>
        <maml:Description>
          <maml:para>Organization name or tenant GUID to include in the URL. Default is 'myorg'.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>OutFile</maml:name>
        <maml:Description>
          <maml:para>Output file for writing the response content to. File path specified must not exist.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
      <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>Url</maml:name>
        <maml:Description>
          <maml:para>Relative or absolute URL of the Power BI entity you want to access. For example, if you want to access https://api.powerbi.com/v1.0/myorg/groups, then specify 'groups', or pass in the entire URL.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>Version</maml:name>
        <maml:Description>
          <maml:para>Version of the API to include in the URL. Default is 'v1.0'. Ignored if -Url is an absolute URL.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
        <dev:type>
          <maml:name>String</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
    </command:parameters>
    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>None</maml:name>
        </dev:type>
        <maml:description>
          <maml:para></maml:para>
        </maml:description>
      </command:inputType>
    </command:inputTypes>
    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>System.String</maml:name>
        </dev:type>
        <maml:description>
          <maml:para></maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>
    <maml:alertSet>
      <maml:alert>
        <maml:para></maml:para>
      </maml:alert>
    </maml:alertSet>
    <command:examples>
      <command:example>
        <maml:title>-------------------------- Example 1 --------------------------</maml:title>
        <dev:code>PS C:\&gt; Invoke-DataGatewayRestMethod -Url 'groups' -Method Get</dev:code>
        <dev:remarks>
          <maml:para>Invokes the URL https://api.powerbi.com/v1.0/myorg/groups with the GET method\verb.</maml:para>
        </dev:remarks>
      </command:example>
    </command:examples>
    <command:relatedLinks />
  </command:command>
  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
    <command:details>
      <command:name>Resolve-DataGatewayError</command:name>
      <command:verb>Resolve</command:verb>
      <command:noun>DataGatewayError</command:noun>
      <maml:description>
        <maml:para>Shows detailed error information produced from DataGateway* cmdlets.</maml:para>
      </maml:description>
    </command:details>
    <maml:description>
      <maml:para>Outputs additional information for any errors produced from DataGateway* cmdlets.</maml:para>
    </maml:description>
    <command:syntax>
      <command:syntaxItem>
        <maml:name>Resolve-DataGatewayError</maml:name>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Environment</maml:name>
          <maml:Description>
            <maml:para>Cloud environment to use. Default is Public.</maml:para>
          </maml:Description>
          <command:parameterValueGroup>
            <command:parameterValue required="false" command:variableLength="false">Public</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">Germany</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGov</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">China</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGovHigh</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGovMil</command:parameterValue>
          </command:parameterValueGroup>
          <command:parameterValue required="true" variableLength="false">PowerBIEnvironmentType</command:parameterValue>
          <dev:type>
            <maml:name>PowerBIEnvironmentType</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none">
          <maml:name>Error</maml:name>
          <maml:Description>
            <maml:para>List of errors to display. For example, $Error[0..2] will show the last three errors.</maml:para>
          </maml:Description>
          <command:parameterValue required="true" variableLength="false">ErrorRecord[]</command:parameterValue>
          <dev:type>
            <maml:name>ErrorRecord[]</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
      </command:syntaxItem>
      <command:syntaxItem>
        <maml:name>Resolve-DataGatewayError</maml:name>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Environment</maml:name>
          <maml:Description>
            <maml:para>Cloud environment to use. Default is Public.</maml:para>
          </maml:Description>
          <command:parameterValueGroup>
            <command:parameterValue required="false" command:variableLength="false">Public</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">Germany</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGov</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">China</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGovHigh</command:parameterValue>
            <command:parameterValue required="false" command:variableLength="false">USGovMil</command:parameterValue>
          </command:parameterValueGroup>
          <command:parameterValue required="true" variableLength="false">PowerBIEnvironmentType</command:parameterValue>
          <dev:type>
            <maml:name>PowerBIEnvironmentType</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
        <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Last</maml:name>
          <maml:Description>
            <maml:para>Indicates to show the last error occurring in the PowerShell session.</maml:para>
          </maml:Description>
          <dev:type>
            <maml:name>SwitchParameter</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>False</dev:defaultValue>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>
    <command:parameters>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>Environment</maml:name>
        <maml:Description>
          <maml:para>Cloud environment to use. Default is Public.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">PowerBIEnvironmentType</command:parameterValue>
        <dev:type>
          <maml:name>PowerBIEnvironmentType</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="named" aliases="none">
        <maml:name>Error</maml:name>
        <maml:Description>
          <maml:para>List of errors to display. For example, $Error[0..2] will show the last three errors.</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">ErrorRecord[]</command:parameterValue>
        <dev:type>
          <maml:name>ErrorRecord[]</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
      <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>Last</maml:name>
        <maml:Description>
          <maml:para>Indicates to show the last error occurring in the PowerShell session.</maml:para>
        </maml:Description>
        <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>
        <dev:type>
          <maml:name>SwitchParameter</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>False</dev:defaultValue>
      </command:parameter>
    </command:parameters>
    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>System.Management.Automation.ErrorRecord[]</maml:name>
        </dev:type>
        <maml:description>
          <maml:para></maml:para>
        </maml:description>
      </command:inputType>
    </command:inputTypes>
    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>System.Object</maml:name>
        </dev:type>
        <maml:description>
          <maml:para></maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>
    <maml:alertSet>
      <maml:alert>
        <maml:para></maml:para>
      </maml:alert>
    </maml:alertSet>
    <command:examples>
      <command:example>
        <maml:title>-------------------------- Example 1 --------------------------</maml:title>
        <dev:code>PS C:\&gt; Resolve-DataGatewayError</dev:code>
        <dev:remarks>
          <maml:para>Displays all errors occurring in the PowerShell session.</maml:para>
        </dev:remarks>
      </command:example>
      <command:example>
        <maml:title>-------------------------- Example 2 --------------------------</maml:title>
        <dev:code>PS C:\&gt; Resolve-DataGatewayError -Last</dev:code>
        <dev:remarks>
          <maml:para>Displays the last error occurring in the PowerShell session.</maml:para>
        </dev:remarks>
      </command:example>
    </command:examples>
    <command:relatedLinks />
  </command:command>
</helpItems>