Get-DataGatewayCluster
現在のユーザーのゲートウェイ クラスターを取得する
構文
Default (既定)
Get-DataGatewayCluster
[-Scope <PowerBIUserScope>]
[-RegionKey <String>]
[-GatewayClusterId <Guid>]
[<CommonParameters>]
説明
指定したクラスター ID に一致し、現在のユーザーが管理者であるゲートウェイ クラスターを取得します。 クラスター ID が指定されていない場合は、ユーザーが管理者であるすべてのゲートウェイ クラスターが返されます。
例
例 1
PS C:\> Get-DataGatewayCluster
現在のユーザーが管理者であるすべてのゲートウェイ クラスターを取得します。
例 2
PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77
指定したゲートウェイ クラスター ID "DC8F2C49-5731-4B27-966B-3DB5094C2E77" のゲートウェイ クラスターの詳細を取得する
例 3
PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 | Select -ExpandProperty MemberGateways
指定したゲートウェイ クラスター ID "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
組織内のすべてのゲートウェイ クラスターを取得します。
注: -Scope Organization オプションを機能させるには、O365 テナント管理者、Power Platform 管理者、または Power BI 管理者である必要があります。
例 6
PS C:\> Get-DataGatewayCluster -RegionKey brazilsouth
自分が管理者であり、ブラジル南部リージョンに関連付けられているゲートウェイクラスターを取得します。
パラメーター
-GatewayClusterId
ゲートウェイクラスターに固有の ID
パラメーターのプロパティ
| 型: | Guid |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | クラスター, ID (アイディー) |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RegionKey
ゲートウェイに関連付けられている Azure リージョン。
-RegionKeyが提供されていない場合は、テナントの既定の Power BI リージョンが使用されます。
使用可能なリージョン パラメーターの一覧を取得するには、Get-DataGatewayRegion コマンドレットを実行します
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Scope
コマンドを実行するセキュリティ スコープ。 これにより、このコマンドをテナント/サービス管理者のスコープで実行しているか、ゲートウェイ管理者のスコープで実行しているかが判断されます
パラメーターのプロパティ
| 型: | PowerBIUserScope |
| 規定値: | Individual |
| 指定可能な値: | Individual, Organization |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。