Partilhar 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 ao ID de cluster especificado e do qual o usuário atual é administrador. Se nenhum ID de cluster for especificado, todos os clusters de gateway dos 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

Obtenha detalhes do cluster de gateway para o ID de cluster de gateway especificado "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 membro associado ao ID de cluster de gateway especificado "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 dentro da sua organização. NOTA: Tem de ser um administrador de inquilino do O365, um administrador da 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 exclusivo para um cluster de gateway

Tipo:Guid
Aliases:Cluster, Id
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 aceites:Individual, Organization
Position:Named
Default value:Individual
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

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