Dela via

Get-SCSPFTenant

  • Referens
Modul:
spfadmin

Hämtar ett eller flera klientobjekt.

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

Cmdleten Get-SCSPFTenant hämtar ett eller flera klientobjekt från Service Provider Foundation. Om du vill skapa en klient använder du cmdleten New-SCSPFTenant.

Exempel

Exempel 1: Hämta alla klienter

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

Det här kommandot visar ID:t och namnen på befintliga klienter.

Exempel 2: Hämta en klientorganisation efter ID

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

Det här kommandot hämtar en klientorganisation efter dess ID.

Exempel 3: Hämta klientorganisationen som är associerad med en betrodd utfärdare

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

Det första kommandot hämtar en betrodd utfärdare.

Det andra kommandot hämtar klientorganisationen som är associerad med en betrodd utfärdare.

Exempel 4: Hämta en klientorganisation efter namn

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

Det här kommandot hämtar en klientorganisation efter dess namn.

Exempel 5: Hämta de klienter som är associerade med ett erbjudande

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

Det här kommandot hämtar en klientorganisation som är associerad med ett erbjudande. För att göra detta hämtar den först det angivna erbjudandet och skickar sedan erbjudandet till cmdleten Get-SCSPFTenant med hjälp av pipelineoperatorn.

Exempel 6: Hämta klientorganisationen som är associerad med en klientanvändarroll

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

Det första kommandot hämtar en klientanvändarroll.

Det andra kommandot hämtar de klienter som är associerade med klientanvändarrollen.

Exempel 7: Hämta de klienter som är associerade med en stämpel

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

Det första kommandot hämtar en stämpel.

Det andra kommandot hämtar de klienter som är associerade med stämpeln.

Parametrar

-ID

Anger ett eller flera GUID för ett visst objekt.

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

-Issuer

Anger ett objekt från en betrodd utfärdare. Om du vill hämta en betrodd utfärdare använder du cmdleten 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

Anger namnet på en eller flera klientorganisationer.

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

-Role

Anger en klientanvändarroll som den här cmdleten returnerar associerade klienter för. Om du vill skaffa en klientanvändarroll använder du cmdleten 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

Anger en stämpel som den här cmdleten returnerar associerade klienter för. Om du vill hämta en stämpel använder du cmdleten Get-SCSPFStamp.

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

Indata

Microsoft.SystemCenter.Foundation.SPFData.Types.Role

Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp

Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer

Utdata

System.Object