Compartilhar via

Get-SCSPFTenant

  • Referência
Módulo:
spfadmin

Obtém um ou mais objetos de locatário.

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 locatário do Service Provider Foundation. Para criar um locatário, use o cmdlet New-SCSPFTenant.

Exemplos

Exemplo 1: Obter todos os locatários

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

Esse comando exibe as IDs e os nomes dos locatários existentes.

Exemplo 2: Obter um locatário por ID

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

Esse comando obtém um locatário por sua ID.

Exemplo 3: Obter o locatário associado a um emissor confiável

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

O primeiro comando obtém um emissor confiável.

O segundo comando obtém o locatário associado a um emissor confiável.

Exemplo 4: Obter um locatário por nome

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

Esse comando obtém um locatário por seu nome.

Exemplo 5: Obter os locatários associados a uma oferta

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

Esse comando obtém um locatário associado a uma oferta. Para fazer isso, ele primeiro obtém a oferta especificada e, em seguida, passa a oferta para o cmdlet Get-SCSPFTenant usando o operador de pipeline.

Exemplo 6: Obter o locatário associado a uma função de usuário de locatário

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

O primeiro comando obtém uma função de usuário de locatário.

O segundo comando obtém os locatários associados à função de usuário do locatário.

Exemplo 7: Obter os locatários associados a um selo

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

O primeiro comando obtém um carimbo.

O segundo comando obtém os locatários associados ao 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 emissor confiável. Para obter um emissor confiável, use o 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 o nome de um ou mais locatários.

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

-Role

Especifica uma função de usuário de locatário para a qual esse cmdlet retorna locatários associados. Para obter uma função de usuário de locatário, use o 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 um carimbo para o qual esse cmdlet retorna locatários associados. Para obter um carimbo, use o 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

Saídas

System.Object