Set-PowerBIWorkspace

Referens

Modul:: MicrosoftPowerBIMgmt.Workspaces

Uppdateringar en Power BI-arbetsyta.

Syntax

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>]

Description

Uppdateringar namnet eller beskrivningen av en Power BI-arbetsyta. Endast arbetsytor i förhandsversionen av den nya arbetsytan stöds. Endast - Omfångsorganisation stöds och du måste ha administratörsbehörighet (till exempel Office 365 global administratör eller Power BI-tjänstadministratör) för att anropa det här kommandot. Innan du kör det här kommandot måste du logga in med Connect-PowerBIServiceAccount.

Exempel

Exempel 1

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

Om den aktuella användaren är administratör uppdateras arbetsytan som matchar det angivna ID:t med angivna namn- och beskrivningsvärden för en arbetsyta i anroparens organisation.

Exempel 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

Om den aktuella användaren är administratör uppdateras det angivna arbetsyteobjektet med angivna namn- och beskrivningsvärden för en arbetsyta i anroparens organisation.

Parametrar

-CapacityId

Det kapacitetsobjekt-ID som en arbetsyta ska tilldelas till. Om CapacityId är inställt på "00000000-0000-0000-00000000000000000000" migreras arbetsytan till delad kapacitet.

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

-Description

Den nya beskrivningen som ska användas för att uppdatera arbetsytan.

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

-Id

ID för arbetsytan som ska uppdateras.

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

-Name

Det nya namnet som ska användas för att uppdatera arbetsytan. Om namnet matchar en annan arbetsyta i organisationen misslyckas uppdateringsåtgärden.

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

-Scope

Anger omfånget för anropet. Endast Organisation stöds med den här cmdleten. Organisationen arbetar mot alla arbetsytor i en klientorganisation (måste vara administratör för att initiera). Enskild är standardinställningen.

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

-Workspace

Den arbetsyteentitet som ska uppdateras. Arbetsytan uppdateras med namnet och beskrivningen på objektet.

Type:	Workspace
Aliases:	Group
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Indata

None

Utdata

System.Object