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