Invoke-PowerBIRestMethod
Wykonuje wywołanie REST do usługa Power BI z określonym adresem URL i treścią.
Składnia
Invoke-PowerBIRestMethod
-Url <String>
-Method <PowerBIWebRequestMethod>
[-Body <String>]
[-OutFile <String>]
[-ContentType <String>]
[-Headers <Hashtable>]
[-TimeoutSec <Int32>]
[-Organization <String>]
[-Version <String>]
[<CommonParameters>]
Opis
Wywołuje żądanie REST względem usługa Power BI przy użyciu profilu, za pomocą którego się zalogowano. Czasownik REST można określić przy użyciu parametru -Method. Parametr -Body jest wymagany dla czasowników POST, PUT i PATCH. Przed uruchomieniem tego polecenia upewnij się, że logujesz się przy użyciu polecenia Connect-PowerBIServiceAccount.
Przykłady
Przykład 1
PS C:\> Invoke-PowerBIRestMethod -Url 'groups' -Method Get
Wywołuje adres URL https://api.powerbi.com/v1.0/myorg/groups za pomocą metody GET\verb.
Parametry
-Body
Treść żądania, znana również jako zawartość. Jest to opcjonalne, chyba że metoda żądania to POST, PUT lub PATCH.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContentType
Typ zawartości do określenia wewnątrz nagłówka żądania. Wartość domyślna to "application/json".
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Headers
Opcjonalne nagłówki do uwzględnienia w żądaniu.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Method
Typ metody żądania HTTP\verb do wykonania za pomocą wywołania.
Type: | PowerBIWebRequestMethod |
Accepted values: | Get, Post, Delete, Put, Patch, Options |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Organization
Nazwa organizacji lub identyfikator GUID dzierżawy do uwzględnienia w adresie URL. Wartość domyślna to "myorg".
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutFile
Plik wyjściowy do zapisywania zawartości odpowiedzi. Określona ścieżka pliku nie może istnieć.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutSec
Określa, jak długo żądanie może być oczekujące przed upływem limitu czasu. Wprowadź wartość w sekundach. Wprowadzenie wartości 0 określa limit czasu nieokreślony.
Type: | Int32 |
Position: | Named |
Default value: | 100 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Url
Względny lub bezwzględny adres URL jednostki usługi Power BI, do której chcesz uzyskać dostęp. Jeśli na przykład chcesz uzyskać dostęp https://api.powerbi.com/v1.0/myorg/groups, określ "grupy" lub przekaż cały adres URL.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Version
Wersja interfejsu API do uwzględnienia w adresie URL. Wartość domyślna to "v1.0". Ignorowane, jeśli -Url jest bezwzględnym adresem URL.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
None
Dane wyjściowe
System.Object
Uwagi
POWIĄZANE LINKI
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla