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