Condividi tramite


Get-DataGatewayCluster

Ottenere i cluster gateway per l'utente corrente

Sintassi

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

Descrizione

Ottiene il cluster gateway che corrisponde all'ID cluster specificato e per il quale l'utente corrente è un amministratore di . Se non viene specificato alcun ID cluster, verranno restituiti tutti i cluster gateway per i quali l'utente è un amministratore.

Esempio

Esempio 1

PS C:\> Get-DataGatewayCluster

Ottiene tutti i cluster gateway di cui l'utente corrente è un amministratore.

Esempio 2

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

Ottenere i dettagli del cluster gateway per l'ID cluster del gateway specificato "DC8F2C49-5731-4B27-966B-3DB5094C2E77"

Esempio 3

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

Ottenere i dettagli di ogni gateway membro associato all'ID cluster del gateway specificato "DC8F2C49-5731-4B27-966B-3DB5094C2E77".

Esempio 4

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

Ottenere un elenco di utenti con autorizzazioni per amministrare o usare il cluster gateway "DC8F2C49-5731-4B27-966B-3DB5094C2E77".

Esempio 5

PS C:\> Get-DataGatewayCluster -Scope Organization

Ottenere tutti i cluster gateway all'interno dell'organizzazione. NOTA: per il funzionamento dell'opzione di -Scope Organization è necessario essere un amministratore tenant di Office 365, un amministratore di Power Platform o un amministratore di Power BI.

Esempio 6

PS C:\> Get-DataGatewayCluster -RegionKey brazilsouth

Ottiene i cluster gateway di cui si è amministratori e sono associati all'area sud del Brasile.

Parametri

-GatewayClusterId

ID per univoco per un cluster gateway

Tipo:Guid
Alias:Cluster, Id
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RegionKey

Area di Azure associata al gateway. Quando non viene fornita una -RegionKey, viene usata l'area predefinita di Power BI per il tenant. Per ottenere l'elenco dei parametri dell'area disponibili, eseguire il cmdlet Get-DataGatewayRegion

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Scope

Ambito di sicurezza per eseguire il comando. Ciò determina se si esegue questo comando nell'ambito di un amministratore tenant/servizio o di un amministratore del gateway

Tipo:PowerBIUserScope
Valori accettati:Individual, Organization
Posizione:Named
Valore predefinito:Individual
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

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