Umgebungseinstellungen lesen und aktualisieren
Viele Einstellungen der Umgebung werden als Spalten in der Organisationstabelle gespeichert.
Die Organisationstabelle hat eine einzelne Zeile und der Primärschlüsselwert OrganizationId ist derselbe Wert wie für Organisations-ID, der im Power Platform Admin Center angezeigt wird. Finden Sie Ihre Umgebung und Organisations-ID
Die Antwort der WhoAmI-Nachricht gibt die OrganizationId-Eigenschaft zurück. Verwenden Sie den organizationid-Wert, um die einzelne Zeile der Organisationstabelle abzurufen. Siehe SDK für .NET WhoAmIRequest-Klasse und Web-API WhoAmI-Funktion.
Unterstützte Einstellungen
Die Dokumentation für die einzelnen Features mit Einstellungen muss die Einstellungen dokumentieren, die geändert werden können. Nicht jede Spalte ist dokumentiert. Es werden nur die in der Featuredokumentation beschriebenen Einstellungen unterstützt.
Beispielsweise werden die folgenden Spalten unterstützt, da sie in der Featuredokumentation erwähnt werden:
Hinweis
Diese Liste ist nicht unbedingt vollständig. Suchen Sie in der Dokumentation des Features, mit dem Sie arbeiten, nach den Einstellungen, die dieses Feature ändern kann.
Nicht unterstützte Einstellungen
Die direkte Aktualisierung einiger Spalten wird ausdrücklich nicht unterstützt. Sie sollten beispielsweise nicht versuchen, die OrgDbOrgSettings-Spalte direkt zu aktualisieren. Diese Zeichenfolgenspalte enthält mehrere XML-Elemente, die das Verhalten für mehrere Features steuern. Wenn Sie diesen Wert falsch aktualisieren, funktionieren Features, die von diesen Einstellungen abhängen, eventuell nicht mehr. Benutzen Sie stets die in Umgebungsdatenbankeinstellungen beschriebenen Tools, um die Werte dieser Spalte zu ändern.
Schreibgeschützte Einstellungen
Einige Einstellungen können zwar abgerufen, aber nicht festgelegt werden. Diese Spalten haben sowohl für AttributeMetadata.IsValidForCreate und AttributeMetadata.IsValidForUpdate falsche Werte. Sie können die Liste der schreibgeschützten Spalten hier anzeigen: Schreibgeschützte Spalten/Attribute der Organisationstabelle.
Hinweis
Wenn Sie wie bei jedem Tabellentyp versuchen, eine schreibgeschützte Spalte festzulegen, verursacht der Vorgang keinen Fehler. Der von Ihnen zum Aktualisieren einer schreibgeschützten Spalte angegebene Wert wird ignoriert.
Einstellungen, die aktualisiert werden können, sind unter Beschreibbare Spalten/Attribute der Organisationstabelle aufgelistet. Bedenken Sie, dass beschreibbar nicht bedeutet, dass das Aktualisieren der Einstellung unterstützt wird.
Veraltete Einstellungen
Bei einigen Spalten handelt es sich um veraltete Einstellungen. Sie sollten sich die Beschreibungen der Spalte in der Liste der Beschreibbaren Spalten/Attribute der Organisationstabelle ansehen, um herauszufinden, ob die Einstellung immer noch die Möglichkeit darstellt, das Umgebungsverhalten zu ändern. Beispielsweise sind die folgenden Spalten veraltet:
- CurrentBulkOperationNumber
- CurrentCampaignNumber
- CurrentCaseNumber
- CurrentCategoryNumber
- CurrentContractNumber
- CurrentInvoiceNumber
- CurrentKaNumber
- CurrentKbNumber
- CurrentOrderNumber
- CurrentQuoteNumber
- MicrosoftFlowEnvironment
Die PAC CLI zum Abrufen und Aktualisieren von Einstellungen verwenden
Sie können Spaltenwerte für die Organisationstabellenzeile mit dem SDK für .NET und der Web-API wie eine Dataverse-Tabelle abrufen und aktualisieren. Sie können auch die Microsoft Power Platform CLI verwenden.
Die PAC-CLI umfasst diese Befehle:
- pac env list-settings: Gibt die in der Organisationstabelle gespeicherten Umgebungseinstellungen zurück.
- pac env update-settings: Ermöglicht die Aktualisierung eines einzelnen Spaltenwerts einer Organisationstabelle.
Achten Sie bei Verwendung des Befehls pac env update-settings darauf, nur die Spalten zu aktualisieren, die aktualisiert werden können. Wenn Sie mit diesem Befehl eine schreibgeschützte Spalte festlegen, meldet der Befehl fälschlicherweise, dass die Änderung erfolgreich angewendet wurde, da kein Fehler aufgetreten ist.