Set-PowerBIWorkspace

Memperbarui ruang kerja Power BI.

Sintaks

Properties (Default)

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

Workspace

Set-PowerBIWorkspace
    -Workspace <Workspace>
    [-Scope <PowerBIUserScope>]
    [<CommonParameters>]

Capacity

Set-PowerBIWorkspace
    -Id <Guid>
    -CapacityId <Guid>
    [-Scope <PowerBIUserScope>]
    [<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 izin atau peran yang sesuai (seperti 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.

Properti parameter

Jenis:Guid
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Capacity
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Description

Deskripsi baru yang akan diberikan ke ruang kerja untuk diperbarui.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Properties
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Id

ID ruang kerja yang akan diperbarui.

Properti parameter

Jenis:Guid
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:IdKelompok, WorkspaceId

Kumpulan parameter

Properties
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False
Capacity
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Properties
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:PowerBIUserScope
Nilai default:None
Nilai yang diterima:Individual, Organization
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Workspace

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

Properti parameter

Jenis:Workspace
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:Kelompok

Kumpulan parameter

Workspace
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

None

Output

System.Object