Set-PowerBIWorkspace

Moduł:

MicrosoftPowerBIMgmt.Workspaces

Aktualizuje obszar roboczy usługi Power BI.

Składnia

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

Opis

Aktualizuje nazwę lub opis obszaru roboczego usługi Power BI. Obsługiwane są tylko obszary robocze w wersji zapoznawczej nowych środowisk obszaru roboczego. Tylko -Scope Organizacja jest obsługiwana i musisz mieć uprawnienia administratora (takie jak administrator globalny usługi Office 365 lub administrator usługi Power BI), aby wywołać to polecenie. Przed uruchomieniem tego polecenia upewnij się, że logujesz się przy użyciu polecenia Connect-PowerBIServiceAccount.

Przykłady

Przykład 1

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

Jeśli bieżący użytkownik jest administratorem, spowoduje to zaktualizowanie obszaru roboczego zgodnego z określonym identyfikatorem z określoną nazwą i wartościami opisu dla obszaru roboczego w organizacji obiektu wywołującego.

Przykład 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

Jeśli bieżący użytkownik jest administratorem, spowoduje to zaktualizowanie określonego obiektu obszaru roboczego przy użyciu określonej nazwy i wartości opisu obszaru roboczego w organizacji obiektu wywołującego.

Parametry

-CapacityId

Identyfikator obiektu pojemności, do którego zostanie przypisany obszar roboczy. Jeśli parametr CapacityId ma wartość "0000000000-0000-0000-0000-000000000000", obszar roboczy zostanie zmigrowany do pojemności udostępnionej.

Typ:	Guid
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Description

Nowy opis umożliwiający aktualizację obszaru roboczego.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Id

Identyfikator obszaru roboczego do zaktualizowania.

Typ:	Guid
Aliasy:	GroupId, WorkspaceId
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Name

Nowa nazwa do nadania obszarowi roboczemu aktualizacji. Jeśli nazwa pasuje do innego obszaru roboczego w organizacji, operacja aktualizacji zakończy się niepowodzeniem.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Scope

Wskazuje zakres wywołania. Tylko organizacja jest obsługiwana za pomocą tego polecenia cmdlet. Organizacja działa we wszystkich obszarach roboczych w ramach dzierżawy (musi być administratorem do zainicjowania). Jednostka jest wartością domyślną.

Typ:	PowerBIUserScope
Dopuszczalne wartości:	Individual, Organization
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Workspace

Jednostka obszaru roboczego do zaktualizowania. Obszar roboczy zostanie zaktualizowany o nazwę i opis obiektu.

Typ:	Workspace
Aliasy:	Group
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

None

Dane wyjściowe

System.Object