Partager via


Set-PowerBIWorkspace

Met à jour un espace de travail Power BI.

Syntaxe

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 -Scope Organisation est prise en charge et vous devez disposer de droits d’administrateur (par exemple, Administrateur général Office 365 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, il 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 « 0000000-0000-0000-0000-00000000000000000 », l’espace de travail est migré vers une capacité partagée.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

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

Type:Guid
Alias:GroupId, WorkspaceId
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeurs acceptées:Individual, Organization
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Alias:Group
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

System.Object