環境設定を読み込んで更新する
環境の多くの設定は、組織テーブルの列として保存されます。
組織テーブルには 1 つの行があり、OrganizationId 主キーの値は、Power Platform 管理センター に表示される 組織 ID 値と同じです。 環境と組織の ID を検索する
WhoAmI
メッセージ応答は OrganizationId
プロパティを返します。 organizationid
値を使用して、組織テーブルの単一行を取得します。 .NET WhoAmIRequest クラス用 SDK と Web API WhoAmI 関数を参照してください。
サポートされている設定
設定のある機能のドキュメントには、変更をサポートする設定を文書化する必要があります。 すべての列が文書化されているわけではありません。 機能ドキュメントに記載されている設定のみが設定可能です。
たとえば、次の列は機能ドキュメントに記載されているためサポートされています。
注意
このリストにすべてが含まれているわけではありません。 使用している機能のドキュメントを参照して、その機能が変更をサポートしている設定を確認してください。
サポートされていない設定
一部の列は、直接更新することが明示的にサポートされていません。 たとえば、 OrgDbOrgSettings 列は直接更新しようとしないでください。 この文字列列には、複数の機能の動作を制御する複数の XML 要素が含まれています。 この値を誤って更新すると、これらの設定に依存する機能が動作しなくなる可能性があります。 必ず、環境データベース設定 に記載されたツールを使って、この列の値を変更します。
読み取り専用設定
一部の設定は取得できますが、設定することはできません。 これらの列には、AttributeMetadata.IsValidForCreate と AttributeMetadata.IsValidForUpdate 両方に偽の値があります。 読み取り専用列のリストはここで確認できます: 組織テーブル 読み取り専用列/属性。
注意
すべての種類のテーブルと同様に、読み取り専用列を設定しようとしても、操作でエラーは発生しません。 読み取り専用列を更新するために指定した値は無視されます。
更新できる設定は、組織テーブル 書き込み可能な列/属性にリストされています。 書き込み可能であることは、設定の更新がサポートされているということではありません。
非推奨の設定
一部の列は非推奨の設定を表します。 組織テーブル 書き込み可能な列/属性 リスト内の列の説明を確認して、設定が依然として環境の動作を変更する方法を表すかどうかを判断する必要があります。 たとえば、次の列は非推奨です。
- CurrentBulkOperationNumber
- CurrentCampaignNumber
- CurrentCaseNumber
- CurrentCategoryNumber
- CurrentContractNumber
- CurrentInvoiceNumber
- CurrentKaNumber
- CurrentKbNumber
- CurrentOrderNumber
- CurrentQuoteNumber
- MicrosoftFlowEnvironment
PAC CLI を使用して設定を取得および更新する
組織テーブル行の列値は、他の Dataverse テーブルと同様に、SDK for .NET および Web API を使用して取得および更新できます。 Microsoft Power Platform CLI を使うこともできます。
PAC CLI には次のコマンドが含まれます。
- pac env list-settings: 組織テーブルに保存されている環境設定を返します。
- pac env update-settings: 単一の組織テーブル列の値を更新できるようにします。
pac env update-settings
コマンドを使用する場合は、更新可能な列のみを更新するようにしてください。 このコマンドを使用して 読み取り専用列を設定すると、エラーが発生しなかったため、変更が正常に適用されたという誤った報告がコマンドによって行われます。