Delen via


Set-PowerBIWorkspace

Hiermee werkt u een Power BI-werkruimte bij.

Syntaxis

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

Hiermee werkt u de naam of beschrijving van een Power BI-werkruimte bij. Alleen werkruimten in de preview-versie van de nieuwe werkruimte-ervaringen worden ondersteund. Alleen -Scope organisatie wordt ondersteund en u moet beschikken over beheerdersrechten (zoals globale beheerder van Office 365 of Power BI-servicebeheerder) om deze opdracht aan te roepen. Voordat u deze opdracht uitvoert, moet u zich aanmelden met Connect-PowerBIServiceAccount.

Voorbeelden

Voorbeeld 1

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

Als de huidige gebruiker een beheerder is, wordt de werkruimte bijgewerkt die overeenkomt met de opgegeven id met de opgegeven naam en beschrijvingswaarden voor een werkruimte in de organisatie van de beller.

Voorbeeld 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

Als de huidige gebruiker een beheerder is, wordt hiermee het opgegeven werkruimteobject bijgewerkt met de opgegeven naam en beschrijvingswaarden voor een werkruimte in de organisatie van de beller.

Parameters

-CapacityId

De capaciteitsobject-id waaraan een werkruimte wordt toegewezen. Als CapacityId is ingesteld op '00000000-0000-0000-0000-00000000000000', wordt de werkruimte gemigreerd naar gedeelde capaciteit.

Type:Guid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

De nieuwe beschrijving die aan de werkruimte moet worden toegevoegd om bij te werken.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

Id van de werkruimte die moet worden bijgewerkt.

Type:Guid
Aliassen:GroupId, WorkspaceId
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

De nieuwe naam die aan de werkruimte moet worden toegevoegd om bij te werken. Als de naam overeenkomt met een andere werkruimte in de organisatie, mislukt de updatebewerking.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Scope

Geeft het bereik van de aanroep aan. Alleen organisatie wordt ondersteund met deze cmdlet. Organisatie werkt op alle werkruimten binnen een tenant (moet een beheerder zijn om te initiƫren). Individu is de standaardinstelling.

Type:PowerBIUserScope
Geaccepteerde waarden:Individual, Organization
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Workspace

De werkruimte-entiteit die moet worden bijgewerkt. De werkruimte wordt bijgewerkt met de naam en beschrijving van het object.

Type:Workspace
Aliassen:Group
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

Uitvoerwaarden

System.Object