Get-EntraContract
拿到合約。
語法
GetQuery (預設值)
Get-EntraContract
[-Top <Int32>]
[-All]
[-Filter <String>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraContract
-ContractId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
Description
指令長 Get-EntraContract 會取得與合作租戶相關的合約資訊。
在工作或學校帳號的委派情境中，該 Directory Readers 角色是唯一支援登入使用者此操作的最低權限角色
範例
範例 1：取得目錄中的所有合約
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract
這個指令會取得所有合約都在 Microsoft Entra ID 裡。
範例 2：取得目錄中排名前兩位的合約
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract -Top 2
此指令在 Microsoft Entra ID 中獲得前兩個合約。 您可以使用 -Limit 作為 -Top的別名。
參數
-All
列出所有頁面。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ContractId
指定合約的識別碼。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ObjectId (物件識別碼) |
參數集
GetById
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Filter
指定 OData v4.0 濾波語句。 此參數控制回傳哪些物件。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
GetQuery
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Property
指定要回傳的屬性。
參數屬性
| 類型: | System.String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 選取 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Top
指定回傳的最大紀錄數量。
參數屬性
| 類型: | System.Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 極限 |
參數集
GetQuery
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
備註
合約物件包含以下屬性：
contractType - 合約類型。
可能的值為：
SyndicationPartner - 表示專門為該客戶轉售並管理 O365 與 Intune 的合作夥伴。 他們轉售並支持顧客。 BreadthPartner - 表示該合作夥伴有能力為該客戶提供行政支援。 但合作夥伴不能轉售給客戶。 轉售夥伴 - 表示與聯合合作夥伴相似的合作夥伴，但不擁有對租戶的獨家存取權。 在聯播的情況下，客戶無法從 Microsoft 或其他合作夥伴購買額外的直接訂閱。
customerContextId - 此合作所參考的客戶租戶唯一識別碼。
對應於客戶租戶 TenantDetail 物件的 ObjectId 屬性。
defaultDomainName - 客戶租戶預設網域名稱的副本。 當與客戶建立合作關係時，該副本即被製作。 如果客戶租戶的預設網域名稱改變，它不會自動更新。
deletionTimestamp - 此屬性對合約無效，且總是回傳 null。
displayName - 客戶租戶的顯示名稱副本。 當與客戶建立合作關係時，該副本即被製作。 如果客戶租戶的顯示名稱改變，系統不會自動更新。
objectType - 用來識別物件類型的字串。 值一律為 Contract。
ContractId - 合作夥伴關係的唯一識別碼。