Get-EntraContract
Ottiene un contratto.
Sintassi
GetQuery (Impostazione predefinita)
Get-EntraContract
[-Top <Int32>]
[-All]
[-Filter <String>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraContract
-ContractId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
Descrizione
Il Get-EntraContract cmdlet ottiene informazioni sul contratto associate a un tenant partner.
Negli scenari delegati con account aziendali o dell'istituto di istruzione, il Directory Readers ruolo è l'unico ruolo con privilegi minimi che supporta questa operazione per l'utente connesso
Esempio
Esempio 1: Ottenere tutti i contratti nella directory
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract
Questo comando ottiene tutti i contratti nel Microsoft Entra ID.
Esempio 2: Ottenere i primi due contratti nella directory
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract -Top 2
Questo comando ottiene i primi due contratti nella Microsoft Entra ID. È possibile usare -Limit come alias per -Top.
Parametri
-All
Elencare tutte le pagine.
Proprietà dei parametri
| Tipo: | System.Management.Automation.SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ContractId
Specifica l'ID di un contratto.
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | ObjectId |
Set di parametri
GetById
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Filter
Specifica un'istruzione filtro OData v4.0. Questo parametro controlla gli oggetti restituiti.
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
GetQuery
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Property
Specifica le proprietà da restituire.
Proprietà dei parametri
| Tipo: | System.String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Select |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Top
Specifica il numero massimo di record da restituire.
Proprietà dei parametri
| Tipo: | System.Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Limit |
Set di parametri
GetQuery
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Note
L'oggetto contratto contiene gli attributi seguenti:
contractType - tipo del contratto.
I valori possibili sono:
SyndicationPartner : indica un partner che rivende e gestisce esclusivamente O365 e Intune per questo cliente. Rivendono e supportano i clienti. BreadthPartner : indica che il partner ha la possibilità di fornire supporto amministrativo per il cliente. Tuttavia, il partner non è autorizzato a rivendere al cliente. ResellerPartner : indica un partner simile a un partner di diffusione, ad eccezione del fatto che non ha accesso esclusivo a un tenant. Nel caso di diffusione, il cliente non può acquistare sottoscrizioni dirette aggiuntive da Microsoft o da altri partner.
customerContextId : identificatore univoco per il tenant del cliente a cui fa riferimento questa relazione.
Corrisponde alla proprietà ObjectId dell'oggetto TenantDetail del tenant del cliente.
defaultDomainName : una copia del nome di dominio predefinito del tenant del cliente. La copia viene eseguita quando viene stabilita la relazione con il cliente. Non viene aggiornato automaticamente se il nome di dominio predefinito del tenant del cliente cambia.
deletionTimestamp : questa proprietà non è valida per i contratti e restituisce sempre Null.
displayName : una copia del nome visualizzato del tenant del cliente. La copia viene eseguita quando viene stabilita la relazione con il cliente. Non viene aggiornato automaticamente se il nome visualizzato del tenant del cliente cambia.
objectType : stringa che identifica il tipo di oggetto. Il valore è sempre Contract.
ContractId : identificatore univoco per la relazione.