Share via

Get-SCSPFTenant

  • Referencia
Módulo:
spfadmin

Obtiene uno o varios objetos de inquilino.

Syntax

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>]

Description

El cmdlet Get-SCSPFTenant obtiene uno o varios objetos de inquilino de Service Provider Foundation. Para crear un inquilino, use el cmdlet New-SCSPFTenant.

Ejemplos

Ejemplo 1: Obtención de todos los inquilinos

PS C:\>Get-SCSPFTenant | Format-Table -Property ID, Name

Este comando muestra los identificadores y los nombres de los inquilinos existentes.

Ejemplo 2: Obtención de un inquilino por identificador

PS C:\>$Tenant = Get-SCSPFTenant -ID e5310370-ab2d-4d51-8336-176999c9cc1e

Este comando obtiene un inquilino por su identificador.

Ejemplo 3: Obtención del inquilino asociado a un emisor de confianza

PS C:\>$TrustedIssuer = Get-SCSPFTrustedIssuer -Name "Contoso"
PS C:\> $Tenant = Get-SCSPFTenant -Issuer $TrustedIssuer

El primer comando obtiene un emisor de confianza.

El segundo comando obtiene el inquilino asociado a un emisor de confianza.

Ejemplo 4: Obtener un inquilino por nombre

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

Este comando obtiene un inquilino por su nombre.

Ejemplo 5: Obtención de los inquilinos asociados a una oferta

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

Este comando obtiene un inquilino asociado a una oferta. Para ello, primero obtiene la oferta especificada y, a continuación, pasa la oferta al cmdlet Get-SCSPFTenant mediante el operador de canalización.

Ejemplo 6: Obtención del inquilino asociado a un rol de usuario de inquilino

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

El primer comando obtiene un rol de usuario de inquilino.

El segundo comando obtiene los inquilinos asociados al rol de usuario del inquilino.

Ejemplo 7: Obtención de los inquilinos asociados a un sello

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

El primer comando obtiene una marca.

El segundo comando obtiene los inquilinos asociados a la marca.

Parámetros

-ID

Especifica uno o varios GUID para un objeto específico.

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

-Issuer

Especifica un objeto de un emisor de confianza. Para obtener un emisor de confianza, use el cmdlet 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

Especifica el nombre de uno o varios inquilinos.

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

-Role

Especifica un rol de usuario de inquilino para el que este cmdlet devuelve inquilinos asociados. Para obtener un rol de usuario de inquilino, use el cmdlet 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

Especifica un sello para el que este cmdlet devuelve inquilinos asociados. Para obtener un sello, use el cmdlet Get-SCSPFStamp.

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

Entradas

Microsoft.SystemCenter.Foundation.SPFData.Types.Role

Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp

Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer

Salidas

System.Object