DataGateway.Profile

3000.10.168

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 either a user or service principal account (application key or certificate). 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="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>ApplicationId</maml:name>
          <maml:Description>
            <maml:para>Azure Active Directory (AAD) application ID (also known as Client ID) to be used with a certificate thumbprint (-CertificateThumbprint) to authenticate with a service principal account (-ServicePrincipal).</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>CertificateThumbprint</maml:name>
          <maml:Description>
            <maml:para>Certificate thumbprint of an installed certificate associated to an Azure Active Directory (AAD) application. Certificate must be installed in either the CurrentUser or LocalMachine personal certificate stores (LocalMachine requires an administrator prompt to access) with a private key installed.</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 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:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>ServicePrincipal</maml:name>
          <maml:Description>
            <maml:para>Indicates to use a service principal account, as opposed to a user account.</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="TenantId">
          <maml:name>Tenant</maml:name>
          <maml:Description>
            <maml:para>Tenant name or tenant ID containing the service principal account. If not specified, the 'COMMON' tenant is used.</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:syntaxItem>
        <maml:name>Connect-DataGatewayServiceAccount</maml:name>
        <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Credential</maml:name>
          <maml:Description>
            <maml:para>PSCredential representing the Azure Active Directory (AAD) application client ID (username) and application secret key (password) to authenticate with a service principal account (-ServicePrincipal).</maml:para>
          </maml:Description>
          <command:parameterValue required="true" variableLength="false">PSCredential</command:parameterValue>
          <dev:type>
            <maml:name>PSCredential</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 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:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>ServicePrincipal</maml:name>
          <maml:Description>
            <maml:para>Indicates to use a service principal account, as opposed to a user account.</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="TenantId">
          <maml:name>Tenant</maml:name>
          <maml:Description>
            <maml:para>Tenant name or tenant ID containing the service principal account. If not specified, the 'COMMON' tenant is used.</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:syntaxItem>
        <maml:name>Connect-DataGatewayServiceAccount</maml:name>
        <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>Credential</maml:name>
          <maml:Description>
            <maml:para>PSCredential representing the Azure Active Directory (AAD) application client ID (username) and application secret key (password) to authenticate with a service principal account (-ServicePrincipal).</maml:para>
          </maml:Description>
          <command:parameterValue required="true" variableLength="false">PSCredential</command:parameterValue>
          <dev:type>
            <maml:name>PSCredential</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 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="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>ApplicationId</maml:name>
        <maml:Description>
          <maml:para>Azure Active Directory (AAD) application ID (also known as Client ID) to be used with a certificate thumbprint (-CertificateThumbprint) to authenticate with a service principal account (-ServicePrincipal).</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>CertificateThumbprint</maml:name>
        <maml:Description>
          <maml:para>Certificate thumbprint of an installed certificate associated to an Azure Active Directory (AAD) application. Certificate must be installed in either the CurrentUser or LocalMachine personal certificate stores (LocalMachine requires an administrator prompt to access) with a private key installed.</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>Credential</maml:name>
        <maml:Description>
          <maml:para>PSCredential representing the Azure Active Directory (AAD) application client ID (username) and application secret key (password) to authenticate with a service principal account (-ServicePrincipal).</maml:para>
        </maml:Description>
        <command:parameterValue required="true" variableLength="false">PSCredential</command:parameterValue>
        <dev:type>
          <maml:name>PSCredential</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 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:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>ServicePrincipal</maml:name>
        <maml:Description>
          <maml:para>Indicates to use a service principal account, as opposed to a user account.</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="TenantId">
        <maml:name>Tenant</maml:name>
        <maml:Description>
          <maml:para>Tenant name or tenant ID containing the service principal account. If not specified, the 'COMMON' tenant is used.</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>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:example>
        <maml:title>-------------------------- Example 3 --------------------------</maml:title>
        <dev:code>PS C:\&gt; Connect-DataGatewayServiceAccount -ServicePrincipal -Credential (Get-Credential)</dev:code>
        <dev:remarks>
          <maml:para>Logs in using a service principal against the Public cloud, a prompt will display from Get-Credential to enter your username (your AAD client ID) and password (your application secret key).</maml:para>
        </dev:remarks>
      </command:example>
      <command:example>
        <maml:title>-------------------------- Example 4 --------------------------</maml:title>
        <dev:code>PS C:\&gt; Connect-DataGatewayServiceAccount -ServicePrincipal -CertificateThumbprint 38DA4BED389A014E69A6E6D8AE56761E85F0DFA4 -ApplicationId b5fde143-722c-4e8d-8113-5b33a9291468</dev:code>
        <dev:remarks>
          <maml:para>Logs in using a service principal with an installed certificate to the Public cloud. The certificate must be installed in either CurrentUser or LocalMachine certificate store (LocalMachine requires administrator access) with a private key installed.</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>