Partilhar via

Set-PowerBIWorkspace

Módulo:
MicrosoftPowerBIMgmt.Workspaces Module

Atualiza um espaço de trabalho do Power BI.

Sintaxe

Properties (Predefinição) 

Set-PowerBIWorkspace
    -Id <Guid>
    [-Scope <PowerBIUserScope>]
    [-Name <String>]
    [-Description <String>]
    [<CommonParameters>]

Workspace 

Set-PowerBIWorkspace
    -Workspace <Workspace>
    [-Scope <PowerBIUserScope>]
    [<CommonParameters>]

Capacity 

Set-PowerBIWorkspace
    -Id <Guid>
    -CapacityId <Guid>
    [-Scope <PowerBIUserScope>]
    [<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 as permissões ou a função apropriadas (como 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.

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Capacity
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Description

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Properties
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Id

ID do espaço de trabalho a ser atualizado.

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Id do Grupo, WorkspaceId

Conjuntos de parâmetros

Properties
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
Capacity
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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á.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Properties
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:PowerBIUserScope
Default value:None
Valores aceites:Individual, Organization
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:Workspace
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Grupo

Conjuntos de parâmetros

Workspace
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

System.Object