Set-PowerBIWorkspace

Référence

Module:: MicrosoftPowerBIMgmt.Workspaces

Met à jour un espace de travail Power BI.

Syntax

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

Description

Met à jour le nom ou la description d’un espace de travail Power BI. Seuls les espaces de travail dans la nouvelle préversion des expériences d’espace de travail sont pris en charge. Seule l’organisation d’étendue est prise en charge et vous devez disposer de droits d’administrateur (tels que Office 365 administrateur général ou Administrateur de service Power BI) pour appeler cette commande. Avant d’exécuter cette commande, veillez à vous connecter à l’aide de Connect-PowerBIServiceAccount.

Exemples

Exemple 1

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

Si l’utilisateur actuel est administrateur, cela met à jour l’espace de travail correspondant à l’ID spécifié avec le nom et les valeurs de description spécifiés pour un espace de travail dans l’organisation de l’appelant.

Exemple 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

Si l’utilisateur actuel est administrateur, cela met à jour l’objet d’espace de travail spécifié avec le nom et les valeurs de description spécifiés pour un espace de travail dans l’organisation de l’appelant.

Paramètres

-CapacityId

ID de l’objet de capacité auquel un espace de travail sera affecté. Si CapacityId est défini sur « 00000000-0000-0000-0000-0000000000000 », l’espace de travail est migré vers la capacité partagée.

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Nouvelle description à donner à l’espace de travail à mettre à jour.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

ID de l’espace de travail à mettre à jour.

Type:	Guid
Aliases:	GroupId, WorkspaceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Nouveau nom à donner à l’espace de travail à mettre à jour. Si le nom correspond à un autre espace de travail dans l’organisation, l’opération de mise à jour échoue.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

Indique l’étendue de l’appel. Seule l’organisation est prise en charge avec cette applet de commande. L’organisation fonctionne sur tous les espaces de travail au sein d’un locataire (doit être un administrateur pour lancer). L’individu est la valeur par défaut.

Type:	PowerBIUserScope
Accepted values:	Individual, Organization
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Workspace

Entité d’espace de travail à mettre à jour. L’espace de travail est mis à jour avec le nom et la description de l’objet.

Type:	Workspace
Aliases:	Group
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

None

Sorties

System.Object

Partager via