Udostępnij przez

Set-PowerBIWorkspace

Moduł:
MicrosoftPowerBIMgmt.Workspaces Module

Aktualizuje obszar roboczy usługi Power BI.

Składnia

Properties (Domyślna) 

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

Opis

Aktualizuje nazwę lub opis obszaru roboczego usługi Power BI. Obsługiwane są tylko obszary robocze w wersji zapoznawczej nowych środowisk obszaru roboczego. Obsługiwana jest tylko -Scope organizacja, a do wywołania tego polecenia musisz mieć odpowiednie uprawnienia lub rolę (na przykład administrator usługi Power BI). 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.

Właściwości parametru

Typ:Guid
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Capacity
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Description

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

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Properties
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Id

Identyfikator obszaru roboczego do zaktualizowania.

Właściwości parametru

Typ:Guid
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator grupy, Identyfikator obszaru roboczego

Zestawy parametrów

Properties
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False
Capacity
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Properties
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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ą.

Właściwości parametru

Typ:PowerBIUserScope
Domyślna wartość:None
Dopuszczalne wartości:Individual, Organization
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Workspace

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

Właściwości parametru

Typ:Workspace
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Grupa

Zestawy parametrów

Workspace
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Dane wyjściowe

System.Object