Set-PowerBIWorkspace

Modul:
MicrosoftPowerBIMgmt.Workspaces Module

Aktualizuje pracovní prostor Power BI.

Syntax

Properties (Výchozí) 

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

Description

Aktualizuje název nebo popis pracovního prostoru Power BI. Podporují se jenom pracovní prostory v novém prostředí pracovních prostorů ve verzi Preview. Podporována je pouze -Scope organizace a k volání tohoto příkazu musíte mít příslušná oprávnění nebo roli (například správce služby Power BI). Před spuštěním tohoto příkazu se ujistěte, že se přihlašujete pomocí connect-PowerBIServiceAccount.

Příklady

Příklad 1

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

Pokud je aktuálním uživatelem správce, aktualizuje se pracovní prostor odpovídající zadanému ID se zadaným názvem a hodnotami popisu pracovního prostoru v organizaci volajícího.

Příklad 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

Pokud je aktuálním uživatelem správce, aktualizuje se zadaný objekt pracovního prostoru zadaným názvem a popisem pracovního prostoru v organizaci volajícího.

Parametry

-CapacityId

ID objektu kapacity, ke kterému bude pracovní prostor přiřazen. Pokud je hodnota CapacityId nastavená na 00000000-0000-0000-0000-000000000000, pracovní prostor se migruje do sdílené kapacity.

Vlastnosti parametru

Typ:Guid
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Capacity
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Description

Nový popis, který se má dát pracovnímu prostoru aktualizovat.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Properties
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Id

ID pracovního prostoru, který se má aktualizovat.

Vlastnosti parametru

Typ:Guid
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Identifikátor skupiny, ID pracovního prostoru

Sady parametrů

Properties
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
Capacity
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Name

Nový název, který má dát pracovnímu prostoru k aktualizaci. Pokud název odpovídá jinému pracovnímu prostoru v organizaci, operace aktualizace selže.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Properties
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Scope

Označuje rozsah volání. Tato rutina podporuje pouze organizaci. Organizace pracuje se všemi pracovními prostory v rámci tenanta (musí být správcem, který se má zahájit). Jednotlivec je výchozí.

Vlastnosti parametru

Typ:PowerBIUserScope
Default value:None
Přípustné hodnoty:Individual, Organization
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Workspace

Entita pracovního prostoru, která se má aktualizovat. Pracovní prostor se aktualizuje názvem a popisem objektu.

Vlastnosti parametru

Typ:Workspace
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Skupina

Sady parametrů

Workspace
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Výstupy

System.Object