Compartilhar via


Get-DataGatewayCluster

Obter clusters de gateway para o usuário atual

Sintaxe

Get-DataGatewayCluster
   [-Scope <PowerBIUserScope>]
   [-RegionKey <String>]
   [-GatewayClusterId <Guid>]
   [<CommonParameters>]

Description

Obtenha um cluster de gateway que corresponda à ID do cluster especificada e da qual o usuário atual é administrador. Se nenhuma ID de cluster for especificada, todos os clusters de gateway para os quais o usuário é administrador serão retornados.

Exemplos

Exemplo 1

PS C:\> Get-DataGatewayCluster

Obtenha todos os clusters de gateway dos quais o usuário atual é administrador.

Exemplo 2

PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77

Obter detalhes do cluster de gateway para a ID do cluster de gateway especificada "DC8F2C49-5731-4B27-966B-3DB5094C2E77"

Exemplo 3

PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 | Select -ExpandProperty MemberGateways

Obtenha detalhes de cada gateway de membro associado à ID do cluster de gateway especificada "DC8F2C49-5731-4B27-966B-3DB5094C2E77".

Exemplo 4

PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 | Select -ExpandProperty Permissions

Obtenha uma lista de usuários com permissões para administrar ou usar o cluster de gateway "DC8F2C49-5731-4B27-966B-3DB5094C2E77".

Exemplo 5

PS C:\> Get-DataGatewayCluster -Scope Organization

Obtenha todos os clusters de gateway em sua organização. OBSERVAÇÃO: você deve ser um administrador de locatário do O365, um administrador do Power Platform ou um administrador do Power BI para que a opção -Scope Organization funcione.

Exemplo 6

PS C:\> Get-DataGatewayCluster -RegionKey brazilsouth

Obtém clusters de gateway dos quais você é administrador e está associado à região sul do Brasil.

Parâmetros

-GatewayClusterId

ID exclusiva para um cluster de gateway

Tipo:Guid
Aliases:Cluster, Id
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RegionKey

A região do Azure associada ao gateway. Quando um -RegionKey não é fornecido, a região padrão do Power BI para seu locatário é usada. Para obter a lista de parâmetros de região disponíveis, execute o cmdlet Get-DataGatewayRegion

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Scope

Escopo de Segurança para executar o comando. Isso determinaria se você está executando esse comando no escopo de um administrador de Locatário/Serviço ou de um Administrador de Gateway

Tipo:PowerBIUserScope
Valores aceitos:Individual, Organization
Cargo:Named
Valor padrão:Individual
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

Microsoft.DataMovement.Powershell.GatewayClient.Gateways.Entities.GatewayCluster