Condividi tramite

Get-SCSPFTenant

  • Riferimento
Modulo:
spfadmin

Ottiene uno o più oggetti tenant.

Sintassi

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

Descrizione

Il cmdlet Get-SCSPFTenant ottiene uno o più oggetti tenant da Service Provider Foundation. Per creare un tenant, usare il cmdlet New-SCSPFTenant.

Esempio

Esempio 1: Ottenere tutti i tenant

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

Questo comando visualizza gli ID e i nomi dei tenant esistenti.

Esempio 2: Ottenere un tenant in base all'ID

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

Questo comando ottiene un tenant in base al relativo ID.

Esempio 3: Ottenere il tenant associato a un'autorità emittente attendibile

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

Il primo comando ottiene un'autorità emittente attendibile.

Il secondo comando ottiene il tenant associato a un'autorità emittente attendibile.

Esempio 4: Ottenere un tenant in base al nome

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

Questo comando ottiene un tenant in base al nome.

Esempio 5: Ottenere i tenant associati a un'offerta

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

Questo comando ottiene un tenant associato a un'offerta. A tale scopo, ottiene prima l'offerta specificata e quindi passa l'offerta al cmdlet Get-SCSPFTenant usando l'operatore pipeline.

Esempio 6: Ottenere il tenant associato a un ruolo utente tenant

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

Il primo comando ottiene un ruolo utente tenant.

Il secondo comando ottiene i tenant associati al ruolo utente tenant.

Esempio 7: Ottenere i tenant associati a un timbro

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

Il primo comando ottiene un timbro.

Il secondo comando ottiene i tenant associati al timbro.

Parametri

-ID

Specifica uno o più GUID per un oggetto specifico.

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

-Issuer

Specifica un oggetto da un'autorità emittente attendibile. Per ottenere un'autorità emittente attendibile, usare il 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

Specifica il nome di uno o più tenant.

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

-Role

Specifica un ruolo utente tenant per il quale questo cmdlet restituisce i tenant associati. Per ottenere un ruolo utente tenant, usare il 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

Specifica un timbro per il quale questo cmdlet restituisce i tenant associati. Per ottenere un timbro, usare il 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

Input

Microsoft.SystemCenter.Foundation.SPFData.Types.Role

Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp

Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer

Output

System.Object