Set-PowerBIWorkspace

Referenz

Modul:: MicrosoftPowerBIMgmt.Workspaces

Aktualisiert einen Power BI-Arbeitsbereich.

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

Beschreibung

Aktualisiert den Namen oder die Beschreibung eines Power BI-Arbeitsbereichs. Nur Arbeitsbereiche in der Vorschau der neuen Arbeitsbereichserfahrung werden unterstützt. Nur -Scope Organisation wird unterstützt, und Sie müssen über Administratorrechte verfügen (z. B. globaler Office 365-Administrator oder Power BI-Dienstadministrator), um diesen Befehl aufzurufen. Bevor Sie diesen Befehl ausführen, stellen Sie sicher, dass Sie sich mit Connect-PowerBIServiceAccount anmelden.

Beispiele

Beispiel 1

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

Wenn der aktuelle Benutzer ein Administrator ist, aktualisiert dies den Arbeitsbereich mit der angegebenen ID mit den angegebenen Namen- und Beschreibungswerten für einen Arbeitsbereich in der Organisation des Anrufers.

Beispiel 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

Wenn der aktuelle Benutzer ein Administrator ist, wird das angegebene Arbeitsbereichsobjekt mit den angegebenen Namen- und Beschreibungswerten für einen Arbeitsbereich in der Organisation des Anrufers aktualisiert.

Parameter

-CapacityId

Die Kapazitätsobjekt-ID, der ein Arbeitsbereich zugewiesen wird. Wenn "CapacityId" auf "00000000-0000-0000-00000-00000000000000" festgelegt ist, wird der Arbeitsbereich zu freigegebener Kapazität migriert.

Typ:	Guid
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Description

Die neue Beschreibung, die dem Arbeitsbereich zum Aktualisieren zugewiesen werden soll.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Id

ID des zu aktualisierenden Arbeitsbereichs.

Typ:	Guid
Aliase:	GroupId, WorkspaceId
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Name

Der neue Name, der dem Zu aktualisierenden Arbeitsbereich zugewiesen werden soll. Wenn der Name einem anderen Arbeitsbereich in der Organisation entspricht, schlägt der Aktualisierungsvorgang fehl.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Scope

Gibt den Bereich des Anrufs an. Nur Die Organisation wird mit diesem Cmdlet unterstützt. Die Organisation funktioniert für alle Arbeitsbereiche innerhalb eines Mandanten (muss ein Administrator sein, der initiiert werden soll). Einzelperson ist die Standardeinstellung.

Typ:	PowerBIUserScope
Zulässige Werte:	Individual, Organization
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Workspace

Die zu aktualisierende Arbeitsbereichsentität. Der Arbeitsbereich wird mit dem Namen und der Beschreibung des Objekts aktualisiert.

Typ:	Workspace
Aliase:	Group
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

None

Ausgaben

System.Object

Freigeben über