Bagikan melalui


Set-PowerBIWorkspace

Memperbarui ruang kerja Power BI.

Sintaks

Set-PowerBIWorkspace
   [-Scope <PowerBIUserScope>]
   -Id <Guid>
   [-Name <String>]
   [-Description <String>]
   [<CommonParameters>]
Set-PowerBIWorkspace
   [-Scope <PowerBIUserScope>]
   -Workspace <Workspace>
   [<CommonParameters>]
Set-PowerBIWorkspace
   [-Scope <PowerBIUserScope>]
   -Id <Guid>
   -CapacityId <Guid>
   [<CommonParameters>]

Deskripsi

Memperbarui nama atau deskripsi ruang kerja Power BI. Hanya ruang kerja di pratinjau pengalaman ruang kerja baru yang didukung. Hanya -Scope Organisasi yang didukung dan Anda harus memiliki hak administrator (seperti Administrator Global Office 365 atau Administrator Layanan Power BI) untuk memanggil perintah ini. Sebelum Anda menjalankan perintah ini, pastikan Anda masuk menggunakan Connect-PowerBIServiceAccount.

Contoh

Contoh 1

PS C:\> Set-PowerBIWorkspace -Scope Organization -Id "3244f1c1-01cf-457f-9383-6035e4950fdc" -Name "Test Name" -Description "Test Description"

Jika pengguna saat ini adalah administrator, ini akan memperbarui ruang kerja yang cocok dengan ID yang ditentukan dengan nilai nama dan deskripsi yang ditentukan untuk ruang kerja di organisasi pemanggil.

Contoh 2

PS C:\> $workspaces = Get-PowerBIWorkspace -Scope Organization
PS C:\> $workspace = $workspaces[0]
PS C:\> $workspace.Name = "Test Name"
PS C:\> $workspace.Description = "Test Description"
PS C:\> Set-PowerBIWorkspace -Scope Organization -Workspace $workspace

Jika pengguna saat ini adalah administrator, ini akan memperbarui objek ruang kerja yang ditentukan dengan nilai nama dan deskripsi yang ditentukan untuk ruang kerja di organisasi pemanggil.

Parameter

-CapacityId

Id objek kapasitas tempat ruang kerja akan ditetapkan. Jika CapacityId diatur ke "00000000-0000-0000-0000-00000000000000", ruang kerja akan dimigrasikan ke kapasitas bersama.

Jenis:Guid
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-Description

Deskripsi baru yang akan diberikan ke ruang kerja untuk diperbarui.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Id

ID ruang kerja yang akan diperbarui.

Jenis:Guid
Alias:GroupId, WorkspaceId
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Name

Nama baru yang akan diberikan ke ruang kerja untuk diperbarui. Jika nama cocok dengan ruang kerja lain di organisasi, operasi pembaruan akan gagal.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Scope

Menunjukkan cakupan panggilan. Hanya Organisasi yang didukung dengan cmdlet ini. Organisasi beroperasi terhadap semua ruang kerja dalam penyewa (harus menjadi administrator untuk memulai). Individu adalah default.

Jenis:PowerBIUserScope
Nilai yang diterima:Individual, Organization
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Workspace

Entitas ruang kerja yang akan diperbarui. Ruang kerja akan diperbarui dengan nama dan deskripsi pada objek.

Jenis:Workspace
Alias:Group
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

Input

None

Output

System.Object