Get-DataGatewayCluster
取得目前使用者的閘道叢集
語法
Get-DataGatewayCluster
[-Scope <PowerBIUserScope>]
[-RegionKey <String>]
[-GatewayClusterId <Guid>]
[<CommonParameters>]
Description
取得符合指定叢集標識碼且目前用戶為系統管理員的閘道叢集。 如果未指定任何叢集標識符,則會傳回用戶為系統管理員的所有閘道叢集。
範例
範例 1
PS C:\> Get-DataGatewayCluster
取得目前使用者為其系統管理員的所有閘道叢集。
範例 2
PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77
取得指定網關叢集標識符的網關叢集詳細數據“DC8F2C49-5731-4B27-966B-3DB5094C2E77”
範例 3
PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 | Select -ExpandProperty MemberGateways
取得與指定閘道叢集標識碼 「DC8F2C49-5731-4B27-966B-3DB5094C2E77」 相關聯的每個成員網關詳細數據。
範例 4
PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 | Select -ExpandProperty Permissions
取得具有管理或使用閘道叢集許可權的使用者清單「DC8F2C49-5731-4B27-966B-3DB5094C2E77」。。
範例 5
PS C:\> Get-DataGatewayCluster -Scope Organization
取得組織內的所有閘道叢集。
注意:您必須是 O365 租用戶系統管理員、Power Platform 系統管理員或 Power BI 系統管理員,才能讓 -Scope Organization
選項運作。
範例 6
PS C:\> Get-DataGatewayCluster -RegionKey brazilsouth
取得您是系統管理員的網關叢集,且與巴西南部區域相關聯。
參數
-GatewayClusterId
閘道叢集唯一的標識碼
類型: | Guid |
別名: | Cluster, Id |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-RegionKey
與閘道相關聯的 Azure 區域。 未提供 -RegionKey
時,會使用租用戶的預設 Power BI 區域。
若要取得可用區域參數的清單,請執行 Get-DataGatewayRegion Cmdlet
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Scope
要執行命令的安全性範圍。 這會判斷您是否在租使用者/服務管理員或閘道管理員的範圍內執行此命令
類型: | PowerBIUserScope |
接受的值: | Individual, Organization |
Position: | Named |
預設值: | Individual |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
None
輸出
Microsoft.DataMovement.Powershell.GatewayClient.Gateways.Entities.GatewayCluster