Get-SCSPFTenant
Obtém um ou mais objetos de locatário.
Sintaxe
Empty (Padrão)
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>]
Description
O cmdlet Get-SCSPFTenant obtém um ou mais objetos de locatário do Service Provider Foundation. Para criar um locatário, use o cmdlet New-SCSPFTenant.
Exemplos
Exemplo 1: Obter todos os locatários
PS C:\>Get-SCSPFTenant | Format-Table -Property ID, Name
Esse comando exibe as IDs e os nomes dos locatários existentes.
Exemplo 2: Obter um locatário por ID
PS C:\>$Tenant = Get-SCSPFTenant -ID e5310370-ab2d-4d51-8336-176999c9cc1e
Esse comando obtém um locatário por sua ID.
Exemplo 3: Obter o locatário associado a um emissor confiável
PS C:\>$TrustedIssuer = Get-SCSPFTrustedIssuer -Name "Contoso"
PS C:\> $Tenant = Get-SCSPFTenant -Issuer $TrustedIssuer
O primeiro comando obtém um emissor confiável.
O segundo comando obtém o locatário associado a um emissor confiável.
Exemplo 4: Obter um locatário por nome
PS C:\>$ContosoTenant = Get-SCSPFTenant -Name "Contoso"
Esse comando obtém um locatário por seu nome.
Exemplo 5: Obter os locatários associados a uma oferta
PS C:\>Get-SCSPFOffer -Name "Contoso" | Get-SCSPFTenant
Esse comando obtém um locatário associado a uma oferta. Para fazer isso, ele primeiro obtém a oferta especificada e, em seguida, passa a oferta para o cmdlet Get-SCSPFTenant usando o operador de pipeline.
Exemplo 6: Obter o locatário associado a uma função de usuário de locatário
PS C:\>$SupervisorRole = Get-SCSPFTenantUserRole -ID e6f9f901-2883-4478-a64e-00c58a423516
PS C:\> $Tenants = Get-SCSPFTenant -Role $SupervisorRole
O primeiro comando obtém uma função de usuário de locatário.
O segundo comando obtém os locatários associados à função de usuário do locatário.
Exemplo 7: Obter os locatários associados a um selo
PS C:\>$ContosoStamp = Get-SCSPFStamp -Name "Contoso"
PS C:\> $Tenants = Get-SCSPFTenant -Stamp $ContosoStamp
O primeiro comando recebe um carimbo.
O segundo comando obtém os locatários associados ao selo.
Parâmetros
-ID
Especifica um ou mais GUIDs para um objeto específico.
Propriedades do parâmetro
| Tipo: | System.Guid[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromTenantIdParameterSetName
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Issuer
Especifica um objeto de um emissor confiável. Para obter um emissor confiável, use o cmdlet Get-SCSPFTrustedIssuer.
Propriedades do parâmetro
| Tipo: | Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromTenantIssuerParameterSetName
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Especifica o nome de um ou mais locatários.
Propriedades do parâmetro
| Tipo: | System.String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromTenantNameParameterSetName
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Role
Especifica uma função de usuário de locatário para a qual esse cmdlet retorna locatários associados. Para obter uma função de usuário de locatário, use o cmdlet Get-SCSPFTenantUserRole.
Propriedades do parâmetro
| Tipo: | Microsoft.SystemCenter.Foundation.SPFData.Types.Role |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromTenantRoleParameterSetName
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Stamp
Especifica um carimbo para o qual esse cmdlet retorna locatários associados. Para obter um carimbo, use o cmdlet Get-SCSPFStamp.
Propriedades do parâmetro
| Tipo: | Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromTenantStampParameterSetName
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.