Get-SCSPFTenant
Obtém um ou mais objetos de locatário.
Sintaxe
Empty (Predefiniçã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 inquilinos
PS C:\>Get-SCSPFTenant | Format-Table -Property ID, Name
Este comando exibe as IDs e os nomes dos locatários existentes.
Exemplo 2: Obter um inquilino por ID
PS C:\>$Tenant = Get-SCSPFTenant -ID e5310370-ab2d-4d51-8336-176999c9cc1e
Este comando obtém um locatário por sua ID.
Exemplo 3: Associar o locatário 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 associa o locatário a um emissor confiável.
Exemplo 4: Obter um inquilino pelo nome
PS C:\>$ContosoTenant = Get-SCSPFTenant -Name "Contoso"
Este comando obtém um locatário por seu nome.
Exemplo 5: Associar os inquilinos a uma oferta
PS C:\>Get-SCSPFOffer -Name "Contoso" | Get-SCSPFTenant
Este 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: Associar o locatário a uma função de usuário 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 locatário.
O segundo comando obtém os locatários associados à função de usuário locatário.
Exemplo 7: Associar os inquilinos a um carimbo
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 carimbo.
Parâmetros
-ID
Especifica um ou mais GUIDs para um objeto específico.
Propriedades dos parâmetros
| Tipo: | System.Guid[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromTenantIdParameterSetName
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Issuer
Especifica um objeto de um emissor confiável. Para obter um emissor confiável, use o cmdlet Get-SCSPFTrustedIssuer.
Propriedades dos parâmetros
| Tipo: | Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromTenantIssuerParameterSetName
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Especifica o nome de um ou mais locatários.
Propriedades dos parâmetros
| Tipo: | System.String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromTenantNameParameterSetName
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Role
Especifica uma função de usuário locatário para a qual esse cmdlet retorna locatários associados. Para obter uma função de usuário locatário, use o cmdlet Get-SCSPFTenantUserRole.
Propriedades dos parâmetros
| Tipo: | Microsoft.SystemCenter.Foundation.SPFData.Types.Role |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromTenantRoleParameterSetName
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Stamp
Especifica um carimbo para o qual esse cmdlet retorna locatários associados. Para obter um carimbo, use o cmdlet Get-SCSPFStamp.
Propriedades dos parâmetros
| Tipo: | Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromTenantStampParameterSetName
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.