Get-DataGatewayCluster
Abrufen von Gatewayclustern für den aktuellen Benutzer
Syntax
Get-DataGatewayCluster
[-Scope <PowerBIUserScope>]
[-RegionKey <String>]
[-GatewayClusterId <Guid>]
[<CommonParameters>]
Beschreibung
Rufen Sie Den Gatewaycluster ab, der der angegebenen Cluster-ID entspricht und für den der aktuelle Benutzer ein Administrator ist. Wenn keine Cluster-ID angegeben ist, werden alle Gatewaycluster zurückgegeben, für die der Benutzer ein Administrator ist.
Beispiele
Beispiel 1
PS C:\> Get-DataGatewayCluster
Ruft alle Gatewaycluster ab, für die der aktuelle Benutzer ein Administrator ist.
Beispiel 2
PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77
Abrufen von Gatewayclusterdetails für die angegebene Gatewaycluster-ID "DC8F2C49-5731-4B27-966B-3DB5094C2E77"
Beispiel 3
PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 | Select -ExpandProperty MemberGateways
Rufen Sie Details zu jedem Mitgliedsgateway ab, das der angegebenen Gatewaycluster-ID "DC8F2C49-5731-4B27-966B-3DB5094C2E77" zugeordnet ist.
Beispiel 4
PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 | Select -ExpandProperty Permissions
Abrufen einer Liste von Benutzern mit Berechtigungen zum Verwalten oder Verwenden des Gatewayclusters "DC8F2C49-5731-4B27-966B-3DB5094C2E77".
Beispiel 5
PS C:\> Get-DataGatewayCluster -Scope Organization
Rufen Sie alle Gatewaycluster in Ihrer Organisation ab.
HINWEIS: Sie müssen ein O365-Mandantenadministrator, Power Platform-Administrator oder ein Power BI-Administrator sein, damit die option -Scope Organization
funktioniert.
Beispiel 6
PS C:\> Get-DataGatewayCluster -RegionKey brazilsouth
Ruft Gatewaycluster ab, von denen Sie administrator sind und der Region Brasilien Süd zugeordnet sind.
Parameter
-GatewayClusterId
ID für einen Gatewaycluster eindeutig
Typ: | Guid |
Aliase: | Cluster, Id |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RegionKey
Die Azure-Region, die dem Gateway zugeordnet ist. Wenn kein -RegionKey
bereitgestellt wird, wird die Standardmäßige Power BI-Region für Ihren Mandanten verwendet.
Um die Liste der verfügbaren Regionsparameter abzurufen, führen Sie das cmdlet Get-DataGatewayRegion aus
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Scope
Sicherheitsbereich zum Ausführen des Befehls. Dies würde bestimmen, ob Sie diesen Befehl im Bereich eines Mandanten-/Dienstadministrators oder eines Gatewayadministrators ausführen.
Typ: | PowerBIUserScope |
Zulässige Werte: | Individual, Organization |
Position: | Named |
Standardwert: | Individual |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
Microsoft.DataMovement.Powershell.GatewayClient.Gateways.Entities.GatewayCluster