Condividi tramite

Set-PowerBIWorkspace

Modulo:
MicrosoftPowerBIMgmt.Workspaces Module

Aggiorna un'area di lavoro di Power BI.

Sintassi

Properties (Impostazione predefinita) 

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

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 ed è necessario disporre delle autorizzazioni o del ruolo appropriati (ad esempio Amministratore del servizio Power BI) per chiamare questo comando. 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.

Proprietà dei parametri

Tipo:Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Capacity
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Description

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Properties
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Id

ID dell'area di lavoro da aggiornare.

Proprietà dei parametri

Tipo:Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ID del Gruppo, WorkspaceId

Set di parametri

Properties
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False
Capacity
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Properties
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:PowerBIUserScope
Valore predefinito:None
Valori accettati:Individual, Organization
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Workspace

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

Proprietà dei parametri

Tipo:Workspace
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Gruppo

Set di parametri

Workspace
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Output

System.Object