Get-SCFabricRole
構文
ByNetworkService (既定)
Get-SCFabricRole
-NetworkService <NetworkService>
[-VMMServer <ServerConnection>]
[-Name <String>]
[-Type <FabricRoleType>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
ByID
Get-SCFabricRole
-ID <Guid>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
説明
Get-SCFabricRole コマンドレットは、ファブリックの役割を取得します。
例
例 1: 既存のファブリックの役割を取得する
PS C:\> $NetworkService = Get-SCNetworkService -Name "ns"
PS C:\> $FabricRole = Get-SCFabricRole -NetworkService $NetworkService -Name "fr"
最初のコマンドは、 Get-SCNetworkService コマンドレットを使用してネットワーク サービスを取得し、それを $NetworkService 変数に格納します。
2 番目のコマンドは、指定した名前を持つ $NetworkService 内のサービスの既存のファブリック ロールを取得します。
パラメーター
-ID
取得するファブリック ロールの ID を指定します。
パラメーターのプロパティ
| 型: | Guid
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByID
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
取得するファブリック ロールの名前を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByNetworkService
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-NetworkService
ネットワーク サービス オブジェクトを指定します。
パラメーターのプロパティ
| 型: | NetworkService
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByNetworkService
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OnBehalfOfUser
ユーザー名を指定します。
このコマンドレットは、このパラメーターで指定されているユーザーに代わって動作します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。
ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを使用します。
このコマンドレットは、このパラメーターで指定されているユーザー ロールに代わって動作します。
パラメーターのプロパティ
| 型: | UserRole
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Type
タイプを指定します。
有効な値は次のとおりです。
パラメーターのプロパティ
| 型: | FabricRoleType
|
| 規定値: | None |
| 指定可能な値: | Unknown, Gateway, LoadBalancer |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByNetworkService
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VMMServer
Virtual Machine Manager (VMM) サーバー オブジェクトを指定します。
パラメーターのプロパティ
| 型: | ServerConnection
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。