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