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