Set-PowerBIWorkspace

Módulo:
MicrosoftPowerBIMgmt.Workspaces Module

Atualiza um workspace do Power BI.

Sintaxe

Properties (Default) 

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 workspace do Power BI. Há suporte apenas para workspaces na nova visualização de experiências de workspace. Há suporte apenas para -Scope organização e você deve ter as permissões ou a função apropriadas (como Administrador de Serviços do Power BI) para chamar esse comando. Antes de executar esse comando, faça logon usando 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 workspace que corresponde à ID especificada com os valores de nome e descrição especificados para um workspace 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 workspace especificado com os valores de nome e descrição especificados para um workspace na organização do chamador.

Parâmetros

-CapacityId

A ID do objeto de capacidade à qual um workspace será atribuído. Se CapacityId estiver definido como "00000000-0000-0000-0000-00000000000000000000", o workspace será migrado para a capacidade compartilhada.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Capacity
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Description

A nova descrição a ser fornecida ao workspace a ser atualizado.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Properties
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Id

ID do workspace a ser atualizado.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Id do Grupo, WorkspaceId

Conjuntos de parâmetros

Properties
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
Capacity
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Properties
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Scope

Indica o escopo da chamada. Somente a Organização tem suporte com esse cmdlet. A organização opera em todos os workspaces dentro de um locatário (deve ser um administrador a ser iniciado). Individual é o padrão.

Propriedades do parâmetro

Tipo:PowerBIUserScope
Valor padrão:None
Valores aceitos:Individual, Organization
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Workspace

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

Propriedades do parâmetro

Tipo:Workspace
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Grupo

Conjuntos de parâmetros

Workspace
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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