Set-PowerBIWorkspace

Riferimento

Modulo:: MicrosoftPowerBIMgmt.Workspaces

Aggiorna un'area di lavoro di Power BI.

Sintassi

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

Descrizione

Aggiorna il nome o la descrizione di un'area di lavoro di Power BI. Sono supportate solo le aree di lavoro nella nuova anteprima delle esperienze dell'area di lavoro. Solo -Scope'organizzazione è supportata e per chiamare questo comando è necessario disporre dei diritti di amministratore (ad esempio amministratore globale di Office 365 o amministratore del servizio Power BI). Prima di eseguire questo comando, assicurarsi di accedere usando Connect-PowerBIServiceAccount.

Esempio

Esempio 1

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

Se l'utente corrente è un amministratore, verrà aggiornata l'area di lavoro corrispondente all'ID specificato con il nome e i valori di descrizione specificati per un'area di lavoro nell'organizzazione del chiamante.

Esempio 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

Se l'utente corrente è un amministratore, l'oggetto area di lavoro specificato verrà aggiornato con il nome e i valori di descrizione specificati per un'area di lavoro nell'organizzazione del chiamante.

Parametri

-CapacityId

ID oggetto capacità a cui verrà assegnata un'area di lavoro. Se CapacityId è impostato su "00000000-0000-0000-0000-000000000000", l'area di lavoro verrà migrata alla capacità condivisa.

Tipo:	Guid
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Description

Nuova descrizione da assegnare all'area di lavoro da aggiornare.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Id

ID dell'area di lavoro da aggiornare.

Tipo:	Guid
Alias:	GroupId, WorkspaceId
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Name

Nuovo nome da assegnare all'area di lavoro da aggiornare. Se il nome corrisponde a un'altra area di lavoro nell'organizzazione, l'operazione di aggiornamento avrà esito negativo.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Scope

Indica l'ambito della chiamata. Solo l'organizzazione è supportata con questo cmdlet. L'organizzazione opera su tutte le aree di lavoro all'interno di un tenant (deve essere un amministratore per avviare). Individual è l'impostazione predefinita.

Tipo:	PowerBIUserScope
Valori accettati:	Individual, Organization
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Workspace

Entità dell'area di lavoro da aggiornare. L'area di lavoro verrà aggiornata con il nome e la descrizione dell'oggetto.

Tipo:	Workspace
Alias:	Group
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

None

Output

System.Object

Condividi tramite