< Back
Restore-PowerBIWorkspace
Post
NAME Restore-PowerBIWorkspace
SYNOPSIS
Restores a deleted Power BI workspace.
SYNTAX
Restore-PowerBIWorkspace -AdminUserPrincipalName <String> -Id <Guid> [-RestoredName <String>] [-Scope {Individual
| Organization}] [<CommonParameters>]
Restore-PowerBIWorkspace -AdminUserPrincipalName <String> [-RestoredName <String>] [-Scope {Individual |
Organization}] -Workspace <Workspace> [<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 preview 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 administrator rights (such as Office 365 Global Administrator or Power BI Service Administrator) to call this
command. You must have logged in previously before using Connect-PowerBIServiceAccount.
PARAMETERS
-AdminUserPrincipalName <String>
User Principal Name (or UPN, commonly an email address) of the user who will become the admin of the restored
workspace.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Id <Guid>
ID of the workspace to restore.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-RestoredName <String>
An optional new name to give to the restored workspace.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Scope <PowerBIUserScope>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Workspace <Workspace>
The workspace entity to be restored.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.Guid
OUTPUTS
System.Object
NOTES
-------------------------- 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.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... e-powerbiw
orkspace?view=powerbi-ps
SYNOPSIS
Restores a deleted Power BI workspace.
SYNTAX
Restore-PowerBIWorkspace -AdminUserPrincipalName <String> -Id <Guid> [-RestoredName <String>] [-Scope {Individual
| Organization}] [<CommonParameters>]
Restore-PowerBIWorkspace -AdminUserPrincipalName <String> [-RestoredName <String>] [-Scope {Individual |
Organization}] -Workspace <Workspace> [<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 preview 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 administrator rights (such as Office 365 Global Administrator or Power BI Service Administrator) to call this
command. You must have logged in previously before using Connect-PowerBIServiceAccount.
PARAMETERS
-AdminUserPrincipalName <String>
User Principal Name (or UPN, commonly an email address) of the user who will become the admin of the restored
workspace.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Id <Guid>
ID of the workspace to restore.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-RestoredName <String>
An optional new name to give to the restored workspace.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Scope <PowerBIUserScope>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Workspace <Workspace>
The workspace entity to be restored.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.Guid
OUTPUTS
System.Object
NOTES
-------------------------- 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.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... e-powerbiw
orkspace?view=powerbi-ps