Restore-PowerBIWorkspace

Modul:

MicrosoftPowerBIMgmt.Workspaces Module

Restores a deleted Power BI workspace.

Syntaxe

Id (Výchozí)

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

Workspace

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

Description

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.

Příklady

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.

Parametry

-AdminUserPrincipalName

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AdminEmailAddress

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Id

ID of the workspace to restore.

Vlastnosti parametru

Typ:	Guid
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	GroupId, WorkspaceId

Sady parametrů

Id

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-RestoredName

An optional new name to give to the restored workspace.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	PowerBIUserScope
Default value:	None
Přípustné hodnoty:	Individual, Organization
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Workspace

The workspace entity to be restored.

Vlastnosti parametru

Typ:	Workspace
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Group

Sady parametrů

Workspace

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vstupy

System.Guid

Výstupy

System.Object