Get-SCSPFTenant
1 つ以上のテナント オブジェクトを取得します。
構文
Empty (既定)
Get-SCSPFTenant
[<CommonParameters>]
FromTenantNameParameterSetName
Get-SCSPFTenant
-Name <String[]>
[<CommonParameters>]
FromTenantIdParameterSetName
Get-SCSPFTenant
-ID <Guid[]>
[<CommonParameters>]
FromTenantRoleParameterSetName
Get-SCSPFTenant
-Role <Role>
[<CommonParameters>]
FromTenantStampParameterSetName
Get-SCSPFTenant
-Stamp <Stamp>
[<CommonParameters>]
FromTenantIssuerParameterSetName
Get-SCSPFTenant
-Issuer <Issuer>
[<CommonParameters>]
説明
Get-SCSPFTenant コマンドレットは、Service Provider Foundation から 1 つ以上のテナント オブジェクトを取得します。 テナントを作成するには、New-SCSPFTenant コマンドレットを使用します。
例
例 1: すべてのテナントを取得する
PS C:\>Get-SCSPFTenant | Format-Table -Property ID, Name
このコマンドは、既存のテナントの ID と名前を表示します。
例 2: ID でテナントを取得する
PS C:\>$Tenant = Get-SCSPFTenant -ID e5310370-ab2d-4d51-8336-176999c9cc1e
このコマンドは、テナントを ID で取得します。
例 3: 信頼された発行者に関連付けられているテナントを取得する
PS C:\>$TrustedIssuer = Get-SCSPFTrustedIssuer -Name "Contoso"
PS C:\> $Tenant = Get-SCSPFTenant -Issuer $TrustedIssuer
最初のコマンドは、信頼できる発行者を取得します。
2 番目のコマンドは、信頼できる発行者に関連付けられたテナントを取得します。
例 4: 名前でテナントを取得する
PS C:\>$ContosoTenant = Get-SCSPFTenant -Name "Contoso"
このコマンドは、テナントを名前で取得します。
例 5: オファーに関連付けられているテナントを取得する
PS C:\>Get-SCSPFOffer -Name "Contoso" | Get-SCSPFTenant
このコマンドは、オファーに関連付けられたテナントを取得します。 これを行うには、最初に指定されたオファーを取得し、次にパイプライン演算子を使用してオファーを Get-SCSPFTenant コマンドレットに渡します。
例 6: テナント ユーザー ロールに関連付けられているテナントを取得する
PS C:\>$SupervisorRole = Get-SCSPFTenantUserRole -ID e6f9f901-2883-4478-a64e-00c58a423516
PS C:\> $Tenants = Get-SCSPFTenant -Role $SupervisorRole
最初のコマンドは、テナント ユーザー ロールを取得します。
2 番目のコマンドは、テナント ユーザー ロールに関連付けられているテナントを取得します。
例 7: スタンプに関連付けられているテナントを取得する
PS C:\>$ContosoStamp = Get-SCSPFStamp -Name "Contoso"
PS C:\> $Tenants = Get-SCSPFTenant -Stamp $ContosoStamp
最初のコマンドはスタンプを取得します。
2 番目のコマンドは、スタンプに関連付けられているテナントを取得します。
パラメーター
-ID
特定のオブジェクトに対して 1 つ以上の GUID を指定します。
パラメーターのプロパティ
| 型: | System.Guid[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FromTenantIdParameterSetName
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Issuer
信頼できる発行者からのオブジェクトを指定します。 信頼された発行者を取得するには、Get-SCSPFTrustedIssuer コマンドレットを使用します。
パラメーターのプロパティ
| 型: | Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FromTenantIssuerParameterSetName
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
1 つ以上のテナントの名前を指定します。
パラメーターのプロパティ
| 型: | System.String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FromTenantNameParameterSetName
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Role
このコマンドレットが関連付けられたテナントを返すテナント ユーザー ロールを指定します。 テナント ユーザー ロールを取得するには、Get-SCSPFTenantUserRole コマンドレットを使用します。
パラメーターのプロパティ
| 型: | Microsoft.SystemCenter.Foundation.SPFData.Types.Role |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FromTenantRoleParameterSetName
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Stamp
このコマンドレットが関連付けられたテナントを返すスタンプを指定します。 スタンプを取得するには、Get-SCSPFStamp コマンドレットを使用します。
パラメーターのプロパティ
| 型: | Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FromTenantStampParameterSetName
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。