Condividi tramite


Restore-PowerBIWorkspace

Restores a deleted Power BI workspace.

Sintassi

Id (impostazione predefinita).

Restore-PowerBIWorkspace
    -Id <Guid>
    -AdminUserPrincipalName <String>
    [-Scope <PowerBIUserScope>]
    [-RestoredName <String>]
    [<CommonParameters>]

Workspace

Restore-PowerBIWorkspace
    -AdminUserPrincipalName <String>
    -Workspace <Workspace>
    [-Scope <PowerBIUserScope>]
    [-RestoredName <String>]
    [<CommonParameters>]

Descrizione

Restores a deleted Power BI workspace with the owner set to the user that matches the specified email address. Only workspaces in the new workspace experiences are supported and only deleted workspaces that haven't reached the data retention policy to be completely removed. Only -Scope Organization is supported and you must have the appropriate permissions or role (such as Power BI Service Administrator) to call this command. You must have logged in previously before using Connect-PowerBIServiceAccount.

Esempio

Example 1

PS C:\> Restore-PowerBIWorkspace -Id "3244f1c1-01cf-457f-9383-6035e4950fdc" -RestoredName "TestWorkspace" -AdminEmailAddress "john@contoso.com"

Restores the workspace with the specified ID, assigns the user with the specified email address as the admin, and updates the name of the workspace to the specified name.

Parametri

-AdminUserPrincipalName

User Principal Name (or UPN, commonly an email address) of the user who will become the admin of the restored workspace.

Proprietà dei parametri

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

Set di parametri

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

-Id

ID of the workspace to restore.

Proprietà dei parametri

Tipo:Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:GroupId, WorkspaceId

Set di parametri

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

-RestoredName

An optional new name to give to the restored workspace.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
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

-Scope

Indicates scope of the call. Individual is not supported; Organization can restore any deleted workspaces within a tenant (must be an administrator to initiate) unless the workspace met its data retention policy and completed removal. Organization is the default.

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

The workspace entity to be restored.

Proprietà dei parametri

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

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

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Input

System.Guid

Output

System.Object