Set-PowerBIWorkspace

Referencia

Módulo:: MicrosoftPowerBIMgmt.Workspaces

Actualiza un área de trabajo de Power BI.

Sintaxis

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

Actualiza el nombre o la descripción de un área de trabajo de Power BI. Solo se admiten las áreas de trabajo de la nueva versión preliminar de experiencias de área de trabajo. Solo se admite -Scope Organización y debe tener derechos de administrador (como administrador global de Office 365 o administrador del servicio Power BI) para llamar a este comando. Antes de ejecutar este comando, asegúrese de iniciar sesión con Connect-PowerBIServiceAccount.

Ejemplos

Ejemplo 1

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

Si el usuario actual es administrador, se actualizará el área de trabajo que coincide con el identificador especificado con los valores de nombre y descripción especificados para un área de trabajo de la organización del autor de la llamada.

Ejemplo 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 el usuario actual es administrador, se actualizará el objeto de área de trabajo especificado con los valores de nombre y descripción especificados para un área de trabajo de la organización del autor de la llamada.

Parámetros

-CapacityId

Identificador de objeto de capacidad al que se asignará un área de trabajo. Si CapacityId está establecido en "000000000-0000-0000-0000-00000000000000", el área de trabajo se migrará a la capacidad compartida.

Tipo:	Guid
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Description

Nueva descripción que se va a proporcionar al área de trabajo que se va a actualizar.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Id

Identificador del área de trabajo que se va a actualizar.

Tipo:	Guid
Alias:	GroupId, WorkspaceId
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Nuevo nombre que se va a asignar al área de trabajo que se va a actualizar. Si el nombre coincide con otra área de trabajo de la organización, se producirá un error en la operación de actualización.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Scope

Indica el ámbito de la llamada. Solo se admite La organización con este cmdlet. La organización funciona con todas las áreas de trabajo de un inquilino (debe ser un administrador para iniciar). Individual es el valor predeterminado.

Tipo:	PowerBIUserScope
Valores aceptados:	Individual, Organization
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Workspace

Entidad del área de trabajo que se va a actualizar. El área de trabajo se actualizará con el nombre y la descripción del objeto.

Tipo:	Workspace
Alias:	Group
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

None

Salidas

System.Object

Compartir a través de