Get-EntraContract
Krijgt een contract.
Syntax
GetQuery (Standaard)
Get-EntraContract
[-Top <Int32>]
[-All]
[-Filter <String>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraContract
-ContractId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
Description
De Get-EntraContract cmdlet haalt een contractgegevens op die zijn gekoppeld aan een partnertenant.
In gedelegeerde scenario's met werk- of schoolaccounts is de rol de Directory Readers enige minst bevoorrechte rol die deze bewerking ondersteunt voor de aangemelde gebruiker
Voorbeelden
Voorbeeld 1: Alle contracten ophalen in de directory
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract
Met deze opdracht worden alle contracten in de Microsoft Entra ID.
Voorbeeld 2: Top twee contracten ophalen in de map
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract -Top 2
Met deze opdracht worden de twee belangrijkste contracten in de Microsoft Entra ID. U kunt -Limit gebruiken als alias voor -Top.
Parameters
-All
Alle pagina's weergeven.
Parametereigenschappen
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-ContractId
Hiermee geeft u de id van een contract.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | ObjectId |
Parametersets
GetById
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Filter
Hiermee geeft u een OData v4.0-filterinstructie op. Met deze parameter bepaalt u welke objecten worden geretourneerd.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
GetQuery
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Property
Hiermee geeft u eigenschappen die moeten worden geretourneerd.
Parametereigenschappen
| Type: | System.String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Selecteren |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Top
Hiermee geeft u het maximum aantal records dat moet worden geretourneerd.
Parametereigenschappen
| Type: | System.Int32 |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Limit |
Parametersets
GetQuery
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Notities
Het contractobject bevat de volgende kenmerken:
contractType - type van het contract.
Mogelijke waarden zijn:
SyndicationPartner : geeft een partner aan die uitsluitend O365 en Intune voor deze klant verkoopt en beheert. Ze verkopen en ondersteunen hun klanten. Breedtepartner - geeft aan dat de partner de mogelijkheid heeft om administratieve ondersteuning te bieden voor deze klant. De partner mag echter niet opnieuw verkopen aan de klant. ResellerPartner : geeft een partner aan die vergelijkbaar is met een syndicatiepartner, behalve dat deze geen exclusieve toegang heeft tot een tenant. In het geval van syndicatie kan de klant geen extra directe abonnementen kopen van Microsoft of van andere partners.
customerContextId - unieke id voor de klanttenant waarnaar wordt verwezen door dit partnerschap.
Komt overeen met de eigenschap ObjectId van het TenantDetail-object van de klanttenant.
defaultDomainName - een kopie van de standaarddomeinnaam van de klanttenant. De kopie wordt gemaakt wanneer de samenwerking met de klant tot stand is gebracht. Deze wordt niet automatisch bijgewerkt als de standaarddomeinnaam van de klanttenant wordt gewijzigd.
deletionTimestamp - deze eigenschap is niet geldig voor contracten en retourneert altijd null.
displayName - een kopie van de weergavenaam van de klanttenant. De kopie wordt gemaakt wanneer de samenwerking met de klant tot stand is gebracht. Deze wordt niet automatisch bijgewerkt als de weergavenaam van de tenant van de klant wordt gewijzigd.
objectType - een tekenreeks die het objecttype identificeert. De waarde is altijd Contract.
ContractId - de unieke id voor het partnerschap.