Get-EntraContract
Obtiene un contrato.
Sintaxis
GetQuery (valor predeterminado)
Get-EntraContract
[-Top <Int32>]
[-All]
[-Filter <String>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraContract
-ContractId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
Description
El Get-EntraContract cmdlet obtiene una información de contrato asociada a un inquilino de asociado.
En escenarios delegados con cuentas profesionales o educativas, el Directory Readers rol es el único rol con privilegios mínimos que admite esta operación para el usuario que ha iniciado sesión.
Ejemplos
Ejemplo 1: Obtener todos los contratos en el directorio
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract
Este comando obtiene todos los contratos del Microsoft Entra ID.
Ejemplo 2: Obtención de los dos principales contratos en el directorio
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract -Top 2
Este comando obtiene los dos primeros contratos del Microsoft Entra ID. Puede usar -Limit como alias para -Top.
Parámetros
-All
Enumera todas las páginas.
Propiedades de parámetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ContractId
Especifica el identificador de un contrato.
Propiedades de parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | ObjectId (identificador de objeto) |
Conjuntos de parámetros
GetById
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Filter
Especifica una instrucción de filtro de OData v4.0. Este parámetro controla qué objetos se devuelven.
Propiedades de parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
GetQuery
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Property
Especifica las propiedades que se van a devolver.
Propiedades de parámetro
| Tipo: | System.String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Select |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Top
Especifica el número máximo de registros que se van a devolver.
Propiedades de parámetro
| Tipo: | System.Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Limit |
Conjuntos de parámetros
GetQuery
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Notas
El objeto contract contiene los atributos siguientes:
contractType - tipo del contrato.
Los valores posibles son:
SyndicationPartner : indica un asociado que revenderá y administra exclusivamente O365 e Intune para este cliente. Revenderán y apoyarán a sus clientes. BreadthPartner : indica que el asociado tiene la capacidad de proporcionar soporte administrativo a este cliente. Sin embargo, el asociado no puede revender al cliente. ResellerPartner : indica un asociado similar a un asociado de distribución, salvo que no tiene acceso exclusivo a un inquilino. En el caso de la distribución, el cliente no puede comprar suscripciones directas adicionales de Microsoft ni de otros asociados.
customerContextId : identificador único para el inquilino del cliente al que hace referencia esta asociación.
Corresponde a la propiedad ObjectId del objeto TenantDetail del inquilino del cliente.
defaultDomainName : una copia del nombre de dominio predeterminado del inquilino del cliente. La copia se realiza cuando se establece la asociación con el cliente. No se actualiza automáticamente si cambia el nombre de dominio predeterminado del inquilino del cliente.
deletionTimestamp : esta propiedad no es válida para contratos y siempre devuelve null.
displayName : una copia del nombre para mostrar del inquilino del cliente. La copia se realiza cuando se establece la asociación con el cliente. No se actualiza automáticamente si cambia el nombre para mostrar del inquilino del cliente.
objectType : una cadena que identifica el tipo de objeto. El valor siempre es Contract.
ContractId : el identificador único de la asociación.