Get-DataGatewayCluster
Obtenir des clusters de passerelle pour l’utilisateur actuel
Syntaxe
Default (Par défaut)
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
Propriétés du paramètre
| Type: | Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Groupe, Id |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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
Propriétés du paramètre
| Type: | PowerBIUserScope |
| Valeur par défaut: | Individual |
| Valeurs acceptées: | Individual, Organization |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.