通过

Get-SCSPFTenant

  • 参考
模块:
spfadmin

获取一个或多个租户对象。

语法

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 cmdlet 从 Service Provider Foundation 获取一个或多个租户对象。 若要创建租户，请使用 New-SCSPFTenant cmdlet。

示例

示例 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

第一个命令获取受信任的颁发者。

第二个命令获取与受信任的颁发者关联的租户。

示例 4：按名称获取租户

PS C:\>$ContosoTenant = Get-SCSPFTenant -Name "Contoso"

此命令按租户名称获取租户。

示例 5：获取与产品/服务关联的租户

PS C:\>Get-SCSPFOffer -Name "Contoso" | Get-SCSPFTenant

此命令获取与产品/服务关联的租户。 为此，它首先获取指定的产品/服务，然后使用管道运算符将产品/服务传递给 Get-SCSPFTenant cmdlet。

示例 6：获取与租户用户角色关联的租户

PS C:\>$SupervisorRole = Get-SCSPFTenantUserRole -ID e6f9f901-2883-4478-a64e-00c58a423516
PS C:\> $Tenants = Get-SCSPFTenant -Role $SupervisorRole

第一个命令获取租户用户角色。

第二个命令获取与租户用户角色关联的租户。

示例 7：获取与戳记关联的租户

PS C:\>$ContosoStamp = Get-SCSPFStamp -Name "Contoso"
PS C:\> $Tenants = Get-SCSPFTenant -Stamp $ContosoStamp

第一个命令获取一个标记。

第二个命令获取与标记关联的租户。

参数

-ID

指定特定对象的一个或多个 GUID。

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

-Issuer

从受信任的颁发者指定对象。 若要获取受信任的颁发者，请使用 Get-SCSPFTrustedIssuer cmdlet。

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

-Name

指定一个或多个租户的名称。

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

-Role

指定此 cmdlet 返回关联租户的租户用户角色。 若要获取租户用户角色，请使用 Get-SCSPFTenantUserRole cmdlet。

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

-Stamp

指定此 cmdlet 返回关联的租户的标记。 若要获取戳记，请使用 Get-SCSPFStamp cmdlet。

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