Get-SCSPFTenant
Ruft ein oder mehrere Mandantenobjekte ab.
Syntax
Empty (Standardwert)
Get-SCSPFTenant
[<CommonParameters>]
FromTenantNameParameterSetName
Get-SCSPFTenant
-Name <String[]>
[<CommonParameters>]
FromTenantIdParameterSetName
Get-SCSPFTenant
-ID <Guid[]>
[<CommonParameters>]
FromTenantRoleParameterSetName
Get-SCSPFTenant
-Role <Role>
[<CommonParameters>]
FromTenantStampParameterSetName
Get-SCSPFTenant
-Stamp <Stamp>
[<CommonParameters>]
FromTenantIssuerParameterSetName
Get-SCSPFTenant
-Issuer <Issuer>
[<CommonParameters>]
Beschreibung
Das Cmdlet Get-SCSPFTenant ruft ein oder mehrere Mandantenobjekte von 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
Mit diesem Befehl werden die IDs und Namen der vorhandenen Mandanten angezeigt.
Beispiel 2: Abrufen eines Mandanten nach ID
PS C:\>$Tenant = Get-SCSPFTenant -ID e5310370-ab2d-4d51-8336-176999c9cc1e
Mit diesem Befehl wird ein Mandant anhand seiner ID abgerufen.
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
Mit dem ersten Befehl wird ein vertrauenswürdiger Aussteller abgerufen.
Mit dem zweiten Befehl wird der Mandant abgerufen, der einem vertrauenswürdigen Aussteller zugeordnet ist.
Beispiel 4: Abrufen eines Mandanten anhand des Namens
PS C:\>$ContosoTenant = Get-SCSPFTenant -Name "Contoso"
Mit diesem Befehl wird ein Mandant anhand seines Namens abgerufen.
Beispiel 5: Abrufen der Mandanten, die einem Angebot zugeordnet sind
PS C:\>Get-SCSPFOffer -Name "Contoso" | Get-SCSPFTenant
Mit diesem Befehl wird ein Mandant abgerufen, der einem Angebot zugeordnet ist. Zu diesem Zweck wird zuerst das angegebene Angebot abgerufen und dann mithilfe des Pipelineoperators an das Cmdlet Get-SCSPFTenant übergeben.
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
Mit dem ersten Befehl wird eine Mandantenbenutzerrolle abgerufen.
Mit dem zweiten Befehl werden die Mandanten abgerufen, 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 erhält einen Stempel.
Mit dem zweiten Befehl werden die Mandanten abgerufen, die dem Stempel zugeordnet sind.
Parameter
-ID
Gibt eine oder mehrere GUIDs für ein bestimmtes Objekt an.
Parametereigenschaften
| Typ: | System.Guid[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromTenantIdParameterSetName
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Issuer
Gibt ein Objekt eines vertrauenswürdigen Ausstellers an. Um einen vertrauenswürdigen Aussteller zu erhalten, verwenden Sie das Cmdlet Get-SCSPFTrustedIssuer.
Parametereigenschaften
| Typ: | Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromTenantIssuerParameterSetName
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt den Namen eines oder mehrerer Mandanten an.
Parametereigenschaften
| Typ: | System.String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromTenantNameParameterSetName
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | Microsoft.SystemCenter.Foundation.SPFData.Types.Role |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromTenantRoleParameterSetName
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromTenantStampParameterSetName
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.