Get-EntraContract
Ruft einen Vertrag ab.
Syntax
GetQuery (Standard)
Get-EntraContract
[-Top <Int32>]
[-All]
[-Filter <String>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraContract
-ContractId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
Beschreibung
Das Get-EntraContract Cmdlet ruft eine Vertragsinformationen ab, die einem Partnermandanten zugeordnet sind.
In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten ist die Directory Readers Rolle die einzige privilegierte Rolle, die diesen Vorgang für den angemeldeten Benutzer unterstützt.
Beispiele
Beispiel 1: Abrufen aller Verträge im Verzeichnis
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract
Dieser Befehl ruft alle Verträge im Microsoft Entra ID ab.
Beispiel 2: Abrufen der beiden wichtigsten Verträge im Verzeichnis
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract -Top 2
Dieser Befehl ruft die beiden wichtigsten Verträge im Microsoft Entra ID ab. Sie können -Limit als Alias für -Top verwenden.
Parameter
-All
Alle Seiten auflisten.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ContractId
Gibt die ID eines Vertrags an.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Objekt-ID |
Parametersätze
GetById
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Filter
Gibt eine OData v4.0-Filter-Anweisung an. Dieser Parameter steuert, welche Objekte zurückgegeben werden.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
GetQuery
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Property
Gibt eigenschaften an, die zurückgegeben werden sollen.
Parametereigenschaften
| Typ: | System.String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Select |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Top
Gibt die maximale Anzahl der zurückzugebenden Datensätze an.
Parametereigenschaften
| Typ: | System.Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Begrenzung |
Parametersätze
GetQuery
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Hinweise
Das Vertragsobjekt enthält die folgenden Attribute:
contractType - Art des Vertrags.
Mögliche Werte:
SyndicationPartner – gibt einen Partner an, der O365 und Intune exklusiv für diesen Kunden weiterverkauft und verwaltet. Sie verkaufen weiter und unterstützen ihre Kunden. BreadthPartner - gibt an, dass der Partner die Möglichkeit hat, administrativen Support für diesen Kunden bereitzustellen. Der Partner darf den Kunden jedoch nicht weiterverkaufen. ResellerPartner – gibt einen Partner an, der einem Syndication-Partner ähnelt, mit der Ausnahme, dass er keinen exklusiven Zugriff auf einen Mandanten hat. Im Syndication-Fall kann der Kunde keine zusätzlichen direkten Abonnements von Microsoft oder anderen Partnern erwerben.
customerContextId - eindeutiger Bezeichner für den Kundenmandanten, auf den von dieser Partnerschaft verwiesen wird.
Entspricht der ObjectId-Eigenschaft des TenantDetail-Objekts des Kundenmandanten.
defaultDomainName – eine Kopie des Standarddomänennamens des Kundenmandanten. Die Kopie wird erstellt, wenn die Partnerschaft mit dem Kunden eingerichtet wird. Er wird nicht automatisch aktualisiert, wenn sich der Standarddomänenname des Kundenmandanten ändert.
deletionTimestamp - Diese Eigenschaft ist für Verträge nicht gültig und gibt immer NULL zurück.
displayName – eine Kopie des Anzeigenamens des Kundenmandanten. Die Kopie wird erstellt, wenn die Partnerschaft mit dem Kunden eingerichtet wird. Er wird nicht automatisch aktualisiert, wenn sich der Anzeigename des Kundenmandanten ändert.
objectType - eine Zeichenfolge, die den Objekttyp identifiziert. Der Wert ist immer Contract.
ContractId - der eindeutige Bezeichner für die Partnerschaft.