Delen via

Get-SCSPFTenant

  • Referentie
Module:
spfadmin

Hiermee haalt u een of meer tenantobjecten op.

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

De cmdlet Get-SCSPFTenant haalt een of meer tenantobjecten op van Service Provider Foundation. Gebruik de cmdlet New-SCSPFTenant om een tenant te maken.

Voorbeelden

Voorbeeld 1: Alle tenants ophalen

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

Met deze opdracht worden de id's en namen van bestaande tenants weergegeven.

Voorbeeld 2: Een tenant ophalen op id

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

Met deze opdracht wordt een tenant opgehaald op basis van de id.

Voorbeeld 3: De tenant ophalen die is gekoppeld aan een vertrouwde verlener

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

Met de eerste opdracht krijgt u een vertrouwde verlener.

Met de tweede opdracht wordt de tenant opgehaald die is gekoppeld aan een vertrouwde verlener.

Voorbeeld 4: Een tenant ophalen op naam

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

Met deze opdracht wordt een tenant opgehaald op basis van de naam.

Voorbeeld 5: De tenants ophalen die zijn gekoppeld aan een aanbieding

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

Met deze opdracht wordt een tenant opgehaald die is gekoppeld aan een aanbieding. Hiervoor krijgt u eerst de opgegeven aanbieding en geeft u vervolgens de aanbieding door aan de Get-SCSPFTenant cmdlet met behulp van de pijplijnoperator.

Voorbeeld 6: De tenant ophalen die is gekoppeld aan een tenantgebruikersrol

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

Met de eerste opdracht wordt een tenantgebruikersrol opgehaald.

Met de tweede opdracht worden de tenants opgehaald die zijn gekoppeld aan de tenantgebruikersrol.

Voorbeeld 7: De tenants ophalen die zijn gekoppeld aan een stempel

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

De eerste opdracht krijgt een stempel.

Met de tweede opdracht worden de tenants opgehaald die aan de stempel zijn gekoppeld.

Parameters

-ID

Hiermee geeft u een of meer GUID's voor een specifiek object op.

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

-Issuer

Hiermee geeft u een object van een vertrouwde verlener. Gebruik de cmdlet Get-SCSPFTrustedIssuer om een vertrouwde verlener te verkrijgen.

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

-Name

Hiermee geeft u de naam van een of meer tenants.

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

-Role

Hiermee geeft u een tenantgebruikersrol op waarvoor deze cmdlet gekoppelde tenants retourneert. Gebruik de cmdlet Get-SCSPFTenantUserRole om een tenantgebruikersrol te verkrijgen.

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

-Stamp

Hiermee geeft u een stempel waarvoor deze cmdlet gekoppelde tenants retourneert. Gebruik de cmdlet Get-SCSPFStamp om een stempel te verkrijgen.

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

Invoerwaarden

Microsoft.SystemCenter.Foundation.SPFData.Types.Role

Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp

Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer

Uitvoerwaarden

System.Object