Freigeben über

Get-SCSPFTenant

  • Referenz
Modul:
spfadmin

Ruft ein oder mehrere Mandantenobjekte ab.

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

Beschreibung

Das Cmdlet Get-SCSPFTenant ruft ein oder mehrere Mandantenobjekte aus der Service Provider Foundation ab. Verwenden Sie zum Erstellen eines Mandanten das Cmdlet New-SCSPFTenant.

Beispiele

Beispiel 1: Abrufen aller Mandanten

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

Dieser Befehl zeigt die IDs und Namen vorhandener Mandanten an.

Beispiel 2: Abrufen eines Mandanten nach ID

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

Dieser Befehl ruft einen Mandanten anhand seiner ID ab.

Beispiel 3: Abrufen des Mandanten, der einem vertrauenswürdigen Aussteller zugeordnet ist

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

Der erste Befehl ruft einen vertrauenswürdigen Aussteller ab.

Der zweite Befehl ruft den Mandanten ab, der einem vertrauenswürdigen Aussteller zugeordnet ist.

Beispiel 4: Abrufen eines Mandanten nach Name

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

Dieser Befehl ruft einen Mandanten nach seinem Namen ab.

Beispiel 5: Abrufen der Mandanten, die einem Angebot zugeordnet sind

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

Dieser Befehl ruft einen Mandanten ab, der einem Angebot zugeordnet ist. Dazu erhält er zuerst das angegebene Angebot und übergibt das Angebot dann mithilfe des Pipelineoperators an das Cmdlet Get-SCSPFTenant.

Beispiel 6: Abrufen des Mandanten, der einer Mandantenbenutzerrolle zugeordnet ist

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

Der erste Befehl ruft eine Mandantenbenutzerrolle ab.

Der zweite Befehl ruft die Mandanten ab, die der Mandantenbenutzerrolle zugeordnet sind.

Beispiel 7: Abrufen der Mandanten, die einem Stempel zugeordnet sind

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

Der erste Befehl ruft einen Stempel ab.

Der zweite Befehl ruft die Mandanten ab, die dem Stempel zugeordnet sind.

Parameter

-ID

Gibt eine oder mehrere GUIDs für ein bestimmtes Objekt an.

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

-Issuer

Gibt ein Objekt aus einem vertrauenswürdigen Aussteller an. Verwenden Sie zum Abrufen eines vertrauenswürdigen Ausstellers das 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

Gibt den Namen eines oder mehrerer Mandanten an.

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

-Role

Gibt eine Mandantenbenutzerrolle an, für die dieses Cmdlet zugeordnete Mandanten zurückgibt. Verwenden Sie zum Abrufen einer Mandantenbenutzerrolle das 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

Gibt einen Stempel an, für den dieses Cmdlet zugeordnete Mandanten zurückgibt. Verwenden Sie zum Abrufen eines Stempels das 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

Eingaben

Microsoft.SystemCenter.Foundation.SPFData.Types.Role

Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp

Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer

Ausgaben

System.Object