Set-PowerBIWorkspace

Odwołanie

Moduł:: MicrosoftPowerBIMgmt.Workspaces

Aktualizacje obszaru roboczego 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

Aktualizacje nazwę lub opis obszaru roboczego usługi Power BI. Obsługiwane są tylko obszary robocze w nowych środowiskach obszarów roboczych w wersji zapoznawczej. Tylko opcja -Scope Organization jest obsługiwana i musisz mieć uprawnienia administratora (takie jak administrator globalny 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 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ść "000000000-0000-0000-0000-00000000000", obszar roboczy zostanie zmigrowany do pojemności udostępnionej.

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Nowy opis do zaktualizowania obszaru roboczego.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Identyfikator obszaru roboczego do zaktualizowania.

Type:	Guid
Aliases:	GroupId, WorkspaceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

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

Type:	PowerBIUserScope
Accepted values:	Individual, Organization
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Workspace

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

Type:	Workspace
Aliases:	Group
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Dane wejściowe

None

Dane wyjściowe

System.Object