Freigeben über


Hierarchy Settings - Create Or Update

Erstellt oder aktualisiert die auf Verwaltungsgruppenebene definierten Hierarchieeinstellungen.

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/settings/default?api-version=2020-05-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
groupId
path True

string

Verwaltungsgruppen-ID.

api-version
query True

string

Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2018-01-01-preview.

Anforderungstext

Name Typ Beschreibung
properties.defaultManagementGroup

string

Einstellungen, die die Standardverwaltungsgruppe festlegen, unter der neue Abonnements in diesem Mandanten hinzugefügt werden. Beispiel: /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation

boolean

Gibt an, ob bei der Gruppenerstellung unter der Stammverwaltungsgruppe RBAC-Zugriff erforderlich ist. Wenn dieser Wert auf true festgelegt ist, benötigt der Benutzer die Aktion Microsoft.Management/managementGroups/write im Bereich der Stammverwaltungsgruppe, um neue Gruppen direkt unter dem Stamm zu erstellen. Dadurch wird verhindert, dass neue Benutzer neue Verwaltungsgruppen erstellen, es sei denn, sie erhalten Zugriff.

Antworten

Name Typ Beschreibung
200 OK

HierarchySettings

OK

Other Status Codes

ErrorResponse

Fehler

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

GetGroupSettings

Beispielanforderung

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/root/settings/default?api-version=2020-05-01

{
  "properties": {
    "defaultManagementGroup": "/providers/Microsoft.Management/managementGroups/DefaultGroup",
    "requireAuthorizationForGroupCreation": true
  }
}

Beispiel für eine Antwort

{
  "id": "/providers/Microsoft.Management/managementGroups/root/settings/default",
  "type": "Microsoft.Management/managementGroups/settings",
  "name": "root",
  "properties": {
    "tenantId": "20000000-0000-0000-0000-000000000000",
    "defaultManagementGroup": "/providers/Microsoft.Management/managementGroups/DefaultGroup",
    "requireAuthorizationForGroupCreation": true
  }
}

Definitionen

Name Beschreibung
CreateOrUpdateSettingsRequest

Parameter zum Erstellen oder Aktualisieren von Verwaltungsgruppeneinstellungen

ErrorDetails

Die Details des Fehlers.

ErrorResponse

Das Fehlerobjekt.

HierarchySettings

Einstellungen, die im Bereich "Verwaltungsgruppe" definiert sind.

CreateOrUpdateSettingsRequest

Parameter zum Erstellen oder Aktualisieren von Verwaltungsgruppeneinstellungen

Name Typ Beschreibung
properties.defaultManagementGroup

string

Einstellungen, die die Standardverwaltungsgruppe festlegen, unter der neue Abonnements in diesem Mandanten hinzugefügt werden. Beispiel: /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation

boolean

Gibt an, ob bei der Gruppenerstellung unter der Stammverwaltungsgruppe RBAC-Zugriff erforderlich ist. Wenn dieser Wert auf true festgelegt ist, benötigt der Benutzer die Aktion Microsoft.Management/managementGroups/write im Bereich der Stammverwaltungsgruppe, um neue Gruppen direkt unter dem Stamm zu erstellen. Dadurch wird verhindert, dass neue Benutzer neue Verwaltungsgruppen erstellen, es sei denn, sie erhalten Zugriff.

ErrorDetails

Die Details des Fehlers.

Name Typ Beschreibung
code

string

Einer von einem serverdefiniertem Satz von Fehlercodes.

details

string

Eine lesbare Darstellung der Fehlerdetails.

message

string

Eine lesbare Darstellung des Fehlers.

ErrorResponse

Das Fehlerobjekt.

Name Typ Beschreibung
error

ErrorDetails

Fehler
Die Details des Fehlers.

HierarchySettings

Einstellungen, die im Bereich "Verwaltungsgruppe" definiert sind.

Name Typ Beschreibung
id

string

Die vollqualifizierte ID für das Einstellungsobjekt. Beispiel: /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000000000/settings/default.

name

string

Der Name des Objekts. In diesem Fall standard.

properties.defaultManagementGroup

string

Einstellungen, die die Standardverwaltungsgruppe festlegen, unter der neue Abonnements in diesem Mandanten hinzugefügt werden. Beispiel: /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation

boolean

Gibt an, ob bei der Gruppenerstellung unter der Stammverwaltungsgruppe RBAC-Zugriff erforderlich ist. Wenn dieser Wert auf true festgelegt ist, benötigt der Benutzer die Aktion Microsoft.Management/managementGroups/write im Bereich der Stammverwaltungsgruppe, um neue Gruppen direkt unter dem Stamm zu erstellen. Dadurch wird verhindert, dass neue Benutzer neue Verwaltungsgruppen erstellen, es sei denn, sie erhalten Zugriff.

properties.tenantId

string

Die den Hierarchieeinstellungen zugeordnete AAD-Mandanten-ID. Beispiel: 00000000-0000-0000-0000-0000000000000

type

string

Der Typ der Ressource. Beispiel: Microsoft.Management/managementGroups/settings.