Partilhar via

Get-SCSPFTenant

  • Referência
Módulo:
spfadmin

Recebe um ou mais 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

O cmdlet Get-SCSPFTenant obtém um ou mais objetos de inquilino da Fundação prestador de serviços. Para criar um inquilino, use o New-SCSPFTenant cmdlet.

Exemplos

Exemplo 1: Obter todos os inquilinos

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

Este comando exibe os IDs e os nomes dos inquilinos existentes.

Exemplo 2: Obter um inquilino por ID

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

Este comando recebe um inquilino pela sua identificação.

Exemplo 3: Obter o inquilino associado a um emitente de confiança

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

O primeiro comando recebe um emitente de confiança.

O segundo comando tem o inquilino associado a um emitente de confiança.

Exemplo 4: Obter um inquilino pelo nome

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

Este comando recebe um inquilino pelo seu nome.

Exemplo 5: Obter os inquilinos associados a uma oferta

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

Este comando recebe um inquilino associado a uma oferta. Para isso, primeiro recebe a oferta especificada e, em seguida, passa a oferta para o Get-SCSPFTenant cmdlet utilizando o operador do gasoduto.

Exemplo 6: Obter o inquilino associado a um papel de utilizador inquilino

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

O primeiro comando recebe um papel de utilizador de inquilino.

O segundo comando recebe os inquilinos associados com o papel de utilizador do inquilino.

Exemplo 7: Obter os inquilinos associados a um carimbo

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

O primeiro comando recebe um selo.

O segundo comando recebe os inquilinos associados com o carimbo.

Parâmetros

-ID

Especifica um ou mais GUIDs para um objeto específico.

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

-Issuer

Especifica um objeto de um emitente de confiança. Para obter um emitente de confiança, utilize o 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

Especifica o nome de um ou mais inquilinos.

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

-Role

Especifica uma função de utilizador do arrendatário para a qual este cmdlet devolve inquilinos associados. Para obter uma função de utilizador do inquilino, utilize o 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

Especifica um carimbo para o qual este cmdlet devolve inquilinos associados. Para obter um carimbo, utilize o 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

Entradas

Microsoft.SystemCenter.Foundation.SPFData.Types.Role

Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp

Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer

Saídas

System.Object