Connect-DataGatewayServiceAccount

Syntax

Connect-DataGatewayServiceAccount
       [-Environment <PowerBIEnvironmentType>]
       [<CommonParameters>]

Connect-DataGatewayServiceAccount
       -ApplicationId <String>
       -ClientSecret <SecureString>
       [-Tenant <String>]
       [-Environment <PowerBIEnvironmentType>]
       [<CommonParameters>]

Connect-DataGatewayServiceAccount
       -ApplicationId <String>
       -CertificateThumbprint <String>
       [-Tenant <String>]
       [-Environment <PowerBIEnvironmentType>]
       [<CommonParameters>]

Description

Anslut till Data Gateway-tjänsten med antingen ett konto för användaren eller tjänstens huvudnamn (programhemlighet eller certifikat).

För användarkonton används ett Azure Active Directory-First-Party program (AAD) för autentisering.

Följ "Skapa ett Azure AD-program" för att skapa ett konto för tjänstens huvudnamn.

Om du vill logga ut anropar du Disconnect-DataGatewayServiceAccount.

Exempel

Skapa ett Azure AD-program

Om du vill skapa ett Azure AD-program som är kompatibelt med DataGateway*-cmdletar kör du följande skript som använder modulen Microsoft.Graph

# In the Azure portal these will show as the Permission names "Tenant.Read.All" and "Tenant.ReadWrite.All" with the "Application" type under the Power BI Service API
$resourceAccessItems = @(
                        @{Id="654b31ae-d941-4e22-8798-7add8fdf049f";Type="Role"},
                        @{Id="28379fa9-8596-4fd9-869e-cb60a93b5d84";Type="Role"}
                        );
# In the Azure portal the ResourceAppId below is the Power BI Service
$resourceAccess = @{ResourceAppId="00000009-0000-0000-c000-000000000000"; ResourceAccess=$resourceAccessItems};

# Create the application, if you do not want the application to have full permissions remove the -RequiredResourceAccess argument
$newApp = New-MgApplication -DisplayName "DataGatewayApplication" -RequiredResourceAccess $resourceAccess

# Optionally, create a secret for the new application
$applicationPasswordRequestOptions = @{PasswordCredential=@{DisplayName="ClientSecret"}}
$applicationPasswordResponse = Add-MgApplicationPassword -ApplicationId $newApp.Id -BodyParameter $applicationPasswordRequestOptions
$clientSecret = $pwd.SecretText | ConvertTo-SecureString -AsPlainText -Force

När du har kört skriptet ovan finns det några fler steg att slutföra:

1. Skapa en ny hemlighet (om du inte skapade en med skriptet ovan) eller använd ett certifikat. Mer information finns i certifikat och hemligheter.

2. Bevilja administratörsmedgivande för programmet med de konfigurerade behörigheterna om du angav argumentet RequiredResourceAccess. Mer information finns i Bevilja administratörsmedgivande i Appregistreringar.

Exempel 1

PS C:\> Connect-DataGatewayServiceAccount

Loggar in med användarautentisering mot det offentliga molnet, en uppmaning visas för att samla in autentiseringsuppgifter.

Exempel 2

PS C:\> Connect-DataGatewayServiceAccount -Environment China

Loggar in med användarautentisering mot Kina-molnet, en uppmaning visas för att samla in autentiseringsuppgifter.

Exempel 3

PS C:\> Connect-DataGatewayServiceAccount -ApplicationId b5fde143-722c-4e8d-8113-5b33a9291468 -ClientSecret (Read-Host "Enter client secret" -AsSecureString) -Tenant 4E6F731E-FD8D-496D-8AF8-349ABC5F62E0

Loggar in med hjälp av en tjänst i den angivna klientorganisationen mot det offentliga molnet. En uppmaning visas från Read-Host för att läsa klientprogramhemligheten.

Exempel 4

PS C:\> ConvertFrom-SecureString -SecureString (Read-Host "Enter client secret" -AsSecureString) | Out-File -FilePath .\encryptedClientSecret.txt
PS C:\> $secureClientSecret = (cat .\encryptedClientSecret.txt | ConvertTo-SecureString)
PS C:\> Connect-DataGatewayServiceAccount -ApplicationId b5fde143-722c-4e8d-8113-5b33a9291468 -ClientSecret $secureClientSecret -Tenant 4E6F731E-FD8D-496D-8AF8-349ABC5F62E0

Loggar in med hjälp av en tjänst i den angivna klientorganisationen mot det offentliga molnet med hjälp av en klienthemlighet som lagras säkert i en fil för att göra cmdleten icke-interaktiv.

Exempel 5

PS C:\> Connect-DataGatewayServiceAccount -ApplicationId b5fde143-722c-4e8d-8113-5b33a9291468 -CertificateThumbprint 38DA4BED389A014E69A6E6D8AE56761E85F0DFA4 -Tenant 4E6F731E-FD8D-496D-8AF8-349ABC5F62E0

Loggar in med tjänstens huvudnamn i den angivna klientorganisationen med ett installerat certifikat till det offentliga molnet. Certifikatet måste vara installerat i antingen CurrentUser- eller LocalMachine-certifikatarkivet (LocalMachine kräver administratörsåtkomst) med en privat nyckel installerad.

Parametrar

-ApplicationId

-CertificateThumbprint

-ClientSecret

-Environment

-Tenant

Indata

None

Utdata

Microsoft.DataMovement.Powershell.Abstractions.Interfaces.IPowerBIProfile