Get-DataGatewayCluster

Référence

Module:: DataGateway

Obtenir des clusters de passerelle pour l’utilisateur actuel

Syntaxe

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

Description

Obtenez le cluster de passerelle qui correspond à l’ID de cluster spécifié et dont l’utilisateur actuel est un administrateur. Si aucun ID de cluster n’est spécifié, tous les clusters de passerelle pour lesquels l’utilisateur est un administrateur seront retournés.

Exemples

Exemple 1

PS C:\> Get-DataGatewayCluster

Obtenez tous les clusters de passerelle dont l’utilisateur actuel est un administrateur.

Exemple 2

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

Obtenir les détails du cluster de passerelle pour l’ID de cluster de passerelle spécifié « DC8F2C49-5731-4B27-966B-3DB5094C2E77 »

Exemple 3

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

Obtenez les détails de chaque passerelle membre associée à l’ID de cluster de passerelle spécifié « DC8F2C49-5731-4B27-966B-3DB5094C2E77 ».

Exemple 4

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

Obtenez la liste des utilisateurs disposant des autorisations nécessaires pour administrer ou utiliser le cluster de passerelle « DC8F2C49-5731-4B27-966B-3DB5094C2E77 ».

Exemple 5

PS C:\> Get-DataGatewayCluster -Scope Organization

Obtenez tous les clusters de passerelle au sein de votre organisation. REMARQUE : Vous devez être un administrateur client O365, un administrateur Power Platform ou un administrateur Power BI pour que l’option -Scope Organization fonctionne.

Exemple 6

PS C:\> Get-DataGatewayCluster -RegionKey brazilsouth

Obtient les clusters de passerelle dont vous êtes administrateur et qui sont associés à la région sud du Brésil.

Paramètres

-GatewayClusterId

ID d’un cluster de passerelle unique à une passerelle

Type:	Guid
Alias:	Cluster, Id
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RegionKey

Région Azure associée à la passerelle. Lorsqu’une -RegionKey n’est pas fournie, la région Power BI par défaut de votre locataire est utilisée. Pour obtenir la liste des paramètres de région disponibles, exécutez l’applet de commande Get-DataGatewayRegion

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Scope

Étendue de sécurité pour exécuter la commande. Cela détermine si vous exécutez cette commande dans l’étendue d’un administrateur client/service ou d’un administrateur de passerelle

Type:	PowerBIUserScope
Valeurs acceptées:	Individual, Organization
Position:	Named
Valeur par défaut:	Individual
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

None

Sorties

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

Partager via