Get-EntraContract
Pobiera kontrakt.
Składnia
GetQuery (domyślnie)
Get-EntraContract
[-Top <Int32>]
[-All]
[-Filter <String>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraContract
-ContractId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
Opis
Polecenie Get-EntraContract cmdlet pobiera informacje o umowie skojarzone z dzierżawą partnera.
W scenariuszach delegowanych z kontami Directory Readers służbowymi rola jest jedyną najmniej uprzywilejowaną rolą, która obsługuje tę operację dla zalogowanego użytkownika
Przykłady
Przykład 1. Pobieranie wszystkich kontraktów w katalogu
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract
To polecenie pobiera wszystkie kontrakty w Microsoft Entra ID.
Przykład 2: Pobieranie dwóch pierwszych kontraktów w katalogu
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract -Top 2
To polecenie pobiera dwa pierwsze kontrakty w Microsoft Entra ID. Możesz użyć -Limit jako aliasu dla -Top.
Parametry
-All
Wyświetl listę wszystkich stron.
Właściwości parametru
| Typ: | System.Management.Automation.SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ContractId
Określa identyfikator kontraktu.
Właściwości parametru
| Typ: | System.String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Identyfikator Obiektu |
Zestawy parametrów
GetById
| Position: | Named |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Filter
Określa instrukcję filtru OData w wersji 4.0. Ten parametr określa, które obiekty są zwracane.
Właściwości parametru
| Typ: | System.String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
GetQuery
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Property
Określa właściwości, które mają być zwracane.
Właściwości parametru
| Typ: | System.String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Select |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Top
Określa maksymalną liczbę rekordów do zwrócenia.
Właściwości parametru
| Typ: | System.Int32 |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Ograniczenie |
Zestawy parametrów
GetQuery
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Notatki
Obiekt kontraktu zawiera następujące atrybuty:
contractType - typ kontraktu.
Dopuszczalne wartości:
SyndicationPartner — wskazuje partnera, który odsprzedaje usługę O365 i usługę Intune dla tego klienta i zarządza nią. Odsprzedają i obsługują swoich klientów. BreadthPartner — wskazuje, że partner ma możliwość zapewnienia pomocy technicznej administracyjnej dla tego klienta. Jednak partner nie może odsprzedać się klientowi. ResellerPartner — wskazuje partnera, który jest podobny do partnera syndykacji, z tą różnicą, że nie ma wyłącznego dostępu do dzierżawy. W przypadku syndykacji klient nie może kupić dodatkowych bezpośrednich subskrypcji od Microsoft ani od innych partnerów.
customerContextId - unikatowy identyfikator dzierżawy klienta, do których odwołuje się to partnerstwo.
Odpowiada właściwości ObjectId obiektu TenantDetail dzierżawy klienta.
defaultDomainName — kopia domyślnej nazwy domeny dzierżawy klienta. Kopia jest dokonana po ustanowieniu partnerstwa z klientem. Nie jest on automatycznie aktualizowany, jeśli domyślna nazwa domeny dzierżawy klienta ulegnie zmianie.
deletionTimestamp — ta właściwość nie jest prawidłowa dla kontraktów i zawsze zwraca wartość null.
displayName — kopia nazwy wyświetlanej dzierżawy klienta. Kopia jest dokonana po ustanowieniu partnerstwa z klientem. Nie jest on automatycznie aktualizowany, jeśli nazwa wyświetlana dzierżawy klienta ulegnie zmianie.
objectType — ciąg identyfikujący typ obiektu. Wartość to zawsze Contract.
ContractId - unikatowy identyfikator partnerstwa.