Get-EntraContract

コントラクトを取得します。

構文

GetQuery (既定)

Get-EntraContract

    [-Top <Int32>]
    [-All]
    [-Filter <String>]
    [-Property <String[]>]
    [<CommonParameters>]

GetById

Get-EntraContract

    -ContractId <String>
    [-All]
    [-Property <String[]>]
    [<CommonParameters>]

説明

Get-EntraContract コマンドレットは、パートナー テナントに関連付けられているコントラクト情報を取得します。

職場または学校アカウントを使用する委任されたシナリオでは、 Directory Readers ロールは、サインインしているユーザーに対してこの操作をサポートする唯一の最小特権ロールです

例 1: ディレクトリ内のすべてのコントラクトを取得する

Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract

このコマンドは、Microsoft Entra ID内のすべてのコントラクトを取得します。

例 2: ディレクトリ内の上位 2 つのコントラクトを取得する

Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraContract -Top 2

このコマンドは、Microsoft Entra IDの上位 2 つのコントラクトを取得します。 -Limitのエイリアスとして-Topを使用できます。

パラメーター

-All

すべてのページを一覧表示します。

パラメーターのプロパティ

型:System.Management.Automation.SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ContractId

コントラクトの ID を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:オブジェクト識別子

パラメーター セット

GetById
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Filter

OData v4.0 フィルター ステートメントを指定します。 このパラメーターは、返されるオブジェクトを制御します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

GetQuery
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Property

返されるプロパティを指定します。

パラメーターのプロパティ

型:

System.String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Select

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Top

返されるレコードの最大数を指定します。

パラメーターのプロパティ

型:System.Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:極限

パラメーター セット

GetQuery
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

メモ

コントラクト オブジェクトには、次の属性が含まれています。

contractType - コントラクトの型。

使用可能な値は次のとおりです。

SyndicationPartner - この顧客の O365 と Intune のみを再販および管理するパートナーを示します。 顧客を再販してサポートします。 BreadthPartner - パートナーがこの顧客の管理サポートを提供できることを示します。 ただし、パートナーは顧客への再販を許可されていません。 ResellerPartner - シンジケーション パートナーに似たパートナーを示しますが、テナントへの排他的アクセス権がありません。 シンジケーションの場合、顧客は Microsoft または他のパートナーから追加の直接サブスクリプションを購入できません。

customerContextId - このパートナーシップによって参照される顧客テナントの一意識別子。

顧客テナントの TenantDetail オブジェクトの ObjectId プロパティに対応します。

defaultDomainName - 顧客テナントの既定のドメイン名のコピー。 コピーは、顧客とのパートナーシップが確立されたときに作成されます。 顧客テナントの既定のドメイン名が変更された場合、自動的には更新されません。

deletionTimestamp - このプロパティはコントラクトには有効ではなく、常に null を返します。

displayName - 顧客テナントの表示名のコピー。 コピーは、顧客とのパートナーシップが確立されたときに作成されます。 顧客テナントの表示名が変更された場合、自動的には更新されません。

objectType - オブジェクトの種類を識別する文字列。 値は常に Contract

ContractId - パートナーシップの一意識別子。