Get-EntraContract
Obtém um contrato.
Sintaxe
GetQuery (Default)
Get-EntraContract
[-Top <Int32>]
[-All]
[-Filter <String>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraContract
-ContractId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
Description
O Get-EntraContract cmdlet obtém informações de contrato associadas a um locatário de parceiro.
Em cenários delegados com contas corporativas ou de estudante, a Directory Readers função é a única função com privilégios mínimos que dá suporte a essa operação para o usuário conectado
Exemplos
Exemplo 1: Obter todos os contratos no diretório
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract
Esse comando obtém todos os contratos no Microsoft Entra ID.
Exemplo 2: Obter os dois principais contratos no diretório
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract -Top 2
Esse comando obtém os dois principais contratos no Microsoft Entra ID. Você pode usar -Limit como um alias para -Top.
Parâmetros
-All
Listar todas as páginas.
Propriedades do parâmetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ContractId
Especifica a ID de um contrato.
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | IdentificadorDeObjeto |
Conjuntos de parâmetros
GetById
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Filter
Especifica uma instrução de filtro OData v4.0. Esse parâmetro controla quais objetos são retornados.
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetQuery
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Property
Especifica as propriedades a serem retornadas.
Propriedades do parâmetro
| Tipo: | System.String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Select |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Top
Especifica o número máximo de registros a serem retornados.
Propriedades do parâmetro
| Tipo: | System.Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Limit |
Conjuntos de parâmetros
GetQuery
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| 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.
Observações
O objeto de contrato contém os seguintes atributos:
contractType - tipo do contrato.
Os valores possíveis são:
SyndicationPartner – indica um parceiro que revende exclusivamente e gerencia o O365 e o Intune para esse cliente. Revendem e suportam os seus clientes. BreadthPartner – indica que o parceiro tem a capacidade de fornecer suporte administrativo para esse cliente. No entanto, o parceiro não tem permissão para revender para o cliente. ResellerPartner – indica um parceiro semelhante a um parceiro de sindicalização, exceto que ele não tem acesso exclusivo a um locatário. No caso da distribuição, o cliente não pode comprar subscrições diretas adicionais da Microsoft ou de outros parceiros.
customerContextId – identificador exclusivo para o locatário do cliente referenciado por essa parceria.
Corresponde à propriedade ObjectId do objeto TenantDetail do locatário do cliente.
defaultDomainName – uma cópia do nome de domínio padrão do locatário do cliente. A cópia é efetuada quando a parceria com o cliente é estabelecida. Não é atualizado automaticamente se o nome de domínio predefinido do inquilino do cliente for alterado.
deletionTimestamp - essa propriedade não é válida para contratos e sempre retorna nulo.
displayName - uma cópia do nome de exibição do locatário do cliente. A cópia é efetuada quando a parceria com o cliente é estabelecida. Não é atualizado automaticamente se o nome a apresentar do inquilino do cliente for alterado.
objectType - uma cadeia de caracteres que identifica o tipo de objeto. O valor é sempre Contract.
ContractId - o identificador exclusivo da parceria.