Get-PowerBIWorkspace

Modul:

MicrosoftPowerBIMgmt.Workspaces

Mengembalikan daftar ruang kerja Power BI.

Sintaks

Get-PowerBIWorkspace
   [-Scope <PowerBIUserScope>]
   [-Filter <String>]
   [-User <String>]
   [-Deleted]
   [-Orphaned]
   [-Type <WorkspaceType>]
   [-First <Int32>]
   [-Skip <Int32>]
   [-Include <ArtifactType[]>]
   [<CommonParameters>]

Get-PowerBIWorkspace
   -Id <Guid>
   [-Scope <PowerBIUserScope>]
   [-Type <WorkspaceType>]
   [-Include <ArtifactType[]>]
   [<CommonParameters>]

Get-PowerBIWorkspace
   -Name <String>
   [-Scope <PowerBIUserScope>]
   [-Type <WorkspaceType>]
   [-Include <ArtifactType[]>]
   [<CommonParameters>]

Get-PowerBIWorkspace
   [-Scope <PowerBIUserScope>]
   [-Filter <String>]
   [-User <String>]
   [-Deleted]
   [-Orphaned]
   [-Type <WorkspaceType>]
   [-Include <ArtifactType[]>]
   [-All]
   [<CommonParameters>]

Deskripsi

Mengambil daftar ruang kerja Power BI yang cocok dengan kriteria dan cakupan pencarian yang ditentukan. Secara default (tanpa parameter -First) ini menunjukkan 100 ruang kerja pertama yang ditetapkan untuk pengguna. Gunakan -First dan -Skip untuk mengambil lebih banyak ruang kerja atau gunakan -All untuk mengembalikan semua ruang kerja. Parameter -First dapat digunakan untuk mengembalikan paling banyak 5000 ruang kerja. Sebelum Anda menjalankan perintah ini, pastikan Anda masuk menggunakan Connect-PowerBIServiceAccount.

Contoh

Contoh 1

PS C:\> Get-PowerBIWorkspace

Mengembalikan 100 ruang kerja Power BI pertama yang ditetapkan pengguna panggilan ke (-Scope Individual).

Contoh 2

PS C:\> Get-PowerBIWorkspace -All

Mengembalikan semua ruang kerja Power BI tempat pengguna panggilan ditetapkan.

Contoh: 3

PS C:\> Get-PowerBIWorkspace -Scope Organization -Filter "tolower(name) eq 'contoso sales'"

Mengembalikan ruang kerja bernama 'Contoso Sales' (tidak peka huruf besar/kecil dengan tolower) dalam organisasi pengguna.

Contoh: 3

PS C:\> Get-PowerBIWorkspace -Scope Organization -Include All

Mengembalikan semua ruang kerja Power BI bersama dengan laporan, dasbor, himpunan data, aliran data, dan buku kerja terkait dalam organisasi pengguna.

Parameter

-All

Menunjukkan untuk menampilkan semua ruang kerja. -Pertama dan -Lewati tidak dapat digunakan dengan parameter ini.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Deleted

Menunjukkan untuk hanya menampilkan ruang kerja yang dihapus. Hanya didukung ketika -Scope Organization ditentukan.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

Filter OData, peka huruf besar/kecil (nama elemen mulai huruf kecil).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-First

Daftar hasil pertama (teratas). Nilai ini default ke 100.

Type:	Int32
Aliases:	Top
Position:	Named
Default value:	100
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

ID ruang kerja yang akan dikembalikan.

Type:	Guid
Aliases:	GroupId, WorkspaceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Include

Mengambil artefak terkait yang terkait dengan ruang kerja Power BI. Hanya tersedia saat -Cakupan adalah Organisasi.

Type:	ArtifactType[]
Aliases:	Expand
Accepted values:	Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Nama ruang kerja yang akan dikembalikan jika ada dengan nama tersebut. Pencarian tidak peka huruf besar/kecil.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Orphaned

Menunjukkan untuk hanya menampilkan ruang kerja tanpa sumber. Hanya didukung ketika -Scope Organization ditentukan.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

Menunjukkan cakupan panggilan. Individu hanya mengembalikan ruang kerja yang ditetapkan ke pemanggil; Organisasi mengembalikan semua ruang kerja dalam penyewa (harus menjadi administrator untuk memulai). Individu adalah default.

Type:	PowerBIUserScope
Accepted values:	Individual, Organization
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Skip

Melewati serangkaian hasil pertama.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

Jenis ruang kerja yang akan dikembalikan. Pencarian peka huruf besar/kecil.

Type:	WorkspaceType
Accepted values:	Workspace, Group, PersonalGroup
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-User

Filter ruang kerja untuk menampilkan ruang kerja tempat pengguna berada. Hanya tersedia saat -Cakupan adalah Organisasi.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Input

None

Output

System.Collections.Generic.IEnumerable`1[[Microsoft.PowerBI.Common.Api.Workspaces.Workspace, Microsoft.PowerBI.Common.Api, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]