Set-PowerBIWorkspace

Referência

Módulo:: MicrosoftPowerBIMgmt.Workspaces

Atualiza um espaço de trabalho do Power BI.

Sintaxe

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

Atualiza o nome ou a descrição de um espaço de trabalho do Power BI. Somente espaços de trabalho na visualização de novas experiências de espaço de trabalho são suportados. Somente -Scope Organização é suportada e você deve ter direitos de administrador (como Administrador Global do Office 365 ou Administrador de Serviço do Power BI) para chamar esse comando. Antes de executar este comando, certifique-se de que inicia sessão utilizando Connect-PowerBIServiceAccount.

Exemplos

Exemplo 1

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

Se o usuário atual for um administrador, isso atualizará o espaço de trabalho correspondente à ID especificada com os valores de nome e descrição especificados para um espaço de trabalho na organização do chamador.

Exemplo 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

Se o usuário atual for um administrador, isso atualizará o objeto de espaço de trabalho especificado com os valores de nome e descrição especificados para um espaço de trabalho na organização do chamador.

Parâmetros

-CapacityId

A ID do objeto de capacidade ao qual um espaço de trabalho será atribuído. Se CapacityId estiver definido como "00000000-0000-0000-0000-0000000000000", o espaço de trabalho será migrado para a capacidade compartilhada.

Tipo:	Guid
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Description

A nova descrição a ser dada ao espaço de trabalho a ser atualizado.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Id

ID do espaço de trabalho a ser atualizado.

Tipo:	Guid
Aliases:	GroupId, WorkspaceId
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Name

O novo nome a ser dado ao espaço de trabalho a ser atualizado. Se o nome corresponder a outro espaço de trabalho na organização, a operação de atualização falhará.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Scope

Indica o escopo da chamada. Somente Organização é suportada com este cmdlet. A organização opera em todos os espaços de trabalho dentro de um locatário (deve ser um administrador para iniciar). Individual é o padrão.

Tipo:	PowerBIUserScope
Valores aceites:	Individual, Organization
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Workspace

A entidade do espaço de trabalho a ser atualizada. O espaço de trabalho será atualizado com o nome e a descrição no objeto.

Tipo:	Workspace
Aliases:	Group
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

None

Saídas

System.Object

Partilhar via