Freigeben über

Set-PowerBIWorkspace

Modul:
MicrosoftPowerBIMgmt.Workspaces Module

Aktualisiert einen Power BI-Arbeitsbereich.

Syntax

Properties (Standardwert) 

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

Beschreibung

Aktualisiert den Namen oder die Beschreibung eines Power BI-Arbeitsbereichs. Nur Arbeitsbereiche in der Vorschau der neuen Arbeitsbereichserfahrung werden unterstützt. Es wird nur -Scope Organisation unterstützt, und Sie müssen über die entsprechenden Berechtigungen oder Rollen (z. B. Power BI-Dienstadministrator) verfügen, um diesen Befehl aufrufen zu können. 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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Capacity
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Description

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Properties
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

ID des zu aktualisierenden Arbeitsbereichs.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Gruppen-ID, WorkspaceId

Parametersätze

Properties
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
Capacity
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Properties
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:PowerBIUserScope
Standardwert:None
Zulässige Werte:Individual, Organization
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Workspace

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

Parametereigenschaften

Typ:Workspace
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Gruppe

Parametersätze

Workspace
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Ausgaben

System.Object