Get-SCSPFTenant

1 つ以上のテナント オブジェクトを取得します。

構文

Get-SCSpfTenant []
Get-SCSPFTenant
   -Name <String[]>
   [<CommonParameters>]
Get-SCSPFTenant
   -ID <Guid[]>
   [<CommonParameters>]
Get-SCSPFTenant
   -Role <Role>
   [<CommonParameters>]
Get-SCSPFTenant
   -Stamp <Stamp>
   [<CommonParameters>]
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 を指定します。

Type:System.Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Issuer

信頼された発行者からのオブジェクトを指定します。 信頼された発行者を取得するには、Get-SCSPFTrustedIssuer コマンドレットを使用します。

Type:Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

1 つ以上のテナントの名前を指定します。

Type:System.String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Role

このコマンドレットが関連付けられているテナントを返すテナント ユーザー ロールを指定します。 テナント ユーザー ロールを取得するには、Get-SCSPFTenantUserRole コマンドレットを使用します。

Type:Microsoft.SystemCenter.Foundation.SPFData.Types.Role
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Stamp

このコマンドレットが関連付けられているテナントを返すスタンプを指定します。 スタンプを取得するには、Get-SCSPFStamp コマンドレットを使用します。

Type:Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

入力

Microsoft.SystemCenter.Foundation.SPFData.Types.Role

Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp

Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer

出力

System.Object