Microsoft.ManagementGroups

Bicep-Ressourcendefinition

Der Ressourcentyp managementGroups ist eine Erweiterungsressource, d. h. Sie können sie auf eine andere Ressource anwenden.

Verwenden Sie die scope -Eigenschaft für diese Ressource, um den Bereich für diese Ressource festzulegen. Weitere Informationen finden Sie unter Festlegen des Bereichs für Erweiterungsressourcen in Bicep.

Der Ressourcentyp managementGroups kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.

Bemerkungen

Legen Sie bei der Bereitstellung im Mandantenbereich die Bereichseigenschaft nicht fest. Weitere Informationen finden Sie unter Erstellen von Verwaltungsgruppen mit Mandantenbereitstellungen in Bicep-Dateien oder ARM-Vorlagen.

Legen Sie bei der Bereitstellung in anderen Bereichen die Bereichseigenschaft für Bicep-Dateien oder / für ARM-Vorlagen auf tenant() fest. Weitere Informationen finden Sie unter Erstellen von Verwaltungsgruppen mit Verwaltungsgruppenbereitstellungen in Bicep-Dateien oder ARM-Vorlagen.

Ressourcenformat

Um eine Microsoft.Management/managementGroups-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.Management/managementGroups@2021-04-01' = {
  name: 'string'
  scope: tenant()
  properties: {
    details: {
      parent: {
        id: 'string'
      }
    }
    displayName: 'string'
  }
}

Eigenschaftswerte

managementGroups

Name Beschreibung Wert
name Der Ressourcenname Zeichenfolge (erforderlich)
scope Verwenden Sie beim Erstellen einer Erweiterungsressource in einem anderen Bereich als dem Bereitstellungsbereich. Für Bicep: tenant().
properties Die generischen Eigenschaften einer Verwaltungsgruppe, die während der Erstellung verwendet wird. CreateManagementGroupPropertiesOrManagementGroupProp...

CreateManagementGroupPropertiesOrManagementGroupProp...

Name Beschreibung Wert
Details Die Details einer Verwaltungsgruppe, die während der Erstellung verwendet wird. CreateManagementGroupDetailsOrManagementGroupDetailsDetails
displayName Der Anzeigename der Verwaltungsgruppe. Wenn kein Wert übergeben wird, wird dieses Feld auf die groupId festgelegt. Zeichenfolge

CreateManagementGroupDetailsOrManagementGroupDetailsDetails

Name Beschreibung Wert
parent (Optional) Die ID der während der Erstellung verwendeten übergeordneten Verwaltungsgruppe. CreateParentGroupInfoOrParentGroupInfo

CreateParentGroupInfoOrParentGroupInfo

Name Beschreibung Wert
id Die vollqualifizierte ID für die übergeordnete Verwaltungsgruppe. Beispiel: /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000 Zeichenfolge

Schnellstartvorlagen

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage Beschreibung
Erstellen einer neuen Verwaltungsgruppe

In Azure bereitstellen
Diese Vorlage ist eine Vorlage auf Mandantenebene, die eine neue Verwaltungsgruppe erstellt.

Ressourcendefinition mit einer ARM-Vorlage

Der Ressourcentyp managementGroups ist eine Erweiterungsressource, d. h. Sie können sie auf eine andere Ressource anwenden.

Verwenden Sie die scope -Eigenschaft für diese Ressource, um den Bereich für diese Ressource festzulegen. Weitere Informationen finden Sie unter Festlegen des Bereichs für Erweiterungsressourcen in ARM-Vorlagen.

Der Ressourcentyp managementGroups kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.

Bemerkungen

Legen Sie bei der Bereitstellung im Mandantenbereich die Bereichseigenschaft nicht fest. Weitere Informationen finden Sie unter Erstellen von Verwaltungsgruppen mit Mandantenbereitstellungen in Bicep-Dateien oder ARM-Vorlagen.

Legen Sie bei der Bereitstellung in anderen Bereichen die Bereichseigenschaft für Bicep-Dateien oder / für ARM-Vorlagen auf tenant() fest. Weitere Informationen finden Sie unter Erstellen von Verwaltungsgruppen mit Verwaltungsgruppenbereitstellungen in Bicep-Dateien oder ARM-Vorlagen.

Ressourcenformat

Um eine Microsoft.Management/managementGroups-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Management/managementGroups",
  "apiVersion": "2021-04-01",
  "name": "string",
  "scope": "/",
  "properties": {
    "details": {
      "parent": {
        "id": "string"
      }
    },
    "displayName": "string"
  }
}

Eigenschaftswerte

managementGroups

Name Beschreibung Wert
type Der Ressourcentyp "Microsoft.Management/managementGroups"
apiVersion Die Version der Ressourcen-API '2021-04-01'
name Der Ressourcenname Zeichenfolge (erforderlich)
scope Verwenden Sie beim Erstellen einer Erweiterungsressource in einem bereich, der sich vom Bereitstellungsbereich unterscheidet. Für JSON: /.
properties Die generischen Eigenschaften einer Verwaltungsgruppe, die während der Erstellung verwendet wird. CreateManagementGroupPropertiesOrManagementGroupProp...

CreateManagementGroupPropertiesOrManagementGroupProp...

Name Beschreibung Wert
Details Die Details einer Verwaltungsgruppe, die während der Erstellung verwendet wird. CreateManagementGroupDetailsOrManagementGroupDetailsDetails
displayName Der Anzeigename der Verwaltungsgruppe. Wenn kein Wert übergeben wird, wird dieses Feld auf die groupId festgelegt. Zeichenfolge

CreateManagementGroupDetailsOrManagementGroupDetailsDetails

Name Beschreibung Wert
parent (Optional) Die ID der übergeordneten Verwaltungsgruppe, die bei der Erstellung verwendet wird. CreateParentGroupInfoOrParentGroupInfo

CreateParentGroupInfoOrParentGroupInfo

Name Beschreibung Wert
id Die vollqualifizierte ID für die übergeordnete Verwaltungsgruppe. Beispiel: /providers/Microsoft.Management/managementGroups/000000000-0000-0000-00000-0000000000000 Zeichenfolge

Schnellstartvorlagen

Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.

Vorlage Beschreibung
Erstellen einer neuen Verwaltungsgruppe

In Azure bereitstellen
Diese Vorlage ist eine Vorlage auf Mandantenebene, die eine neue Verwaltungsgruppe erstellt.

Terraform (AzAPI-Anbieter) Ressourcendefinition

Der Ressourcentyp managementGroups ist eine Erweiterungsressource, was bedeutet, dass Sie sie auf eine andere Ressource anwenden können.

Verwenden Sie die parent_id -Eigenschaft für diese Ressource, um den Bereich für diese Ressource festzulegen.

Der Ressourcentyp managementGroups kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

  • Mandanten

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Management/managementGroups-Ressource zu erstellen, fügen Sie Der Vorlage die folgende Terraform-Ressource hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Management/managementGroups@2021-04-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      details = {
        parent = {
          id = "string"
        }
      }
      displayName = "string"
    }
  })
}

Eigenschaftswerte

managementGroups

Name Beschreibung Wert
type Ressourcentyp "Microsoft.Management/managementGroups@2021-04-01"
name Der Ressourcenname Zeichenfolge (erforderlich)
parent_id Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. Zeichenfolge (erforderlich)
properties Die generischen Eigenschaften einer Verwaltungsgruppe, die während der Erstellung verwendet wird. CreateManagementGroupPropertiesOrManagementGroupProp...

CreateManagementGroupPropertiesOrManagementGroupProp...

Name Beschreibung Wert
Details Die Details einer Verwaltungsgruppe, die während der Erstellung verwendet wird. CreateManagementGroupDetailsOrManagementGroupDetailsDetails
displayName Der Anzeigename der Verwaltungsgruppe. Wenn kein Wert übergeben wird, wird dieses Feld auf die groupId festgelegt. Zeichenfolge

CreateManagementGroupDetailsOrManagementGroupDetailsDetails

Name Beschreibung Wert
parent (Optional) Die ID der übergeordneten Verwaltungsgruppe, die bei der Erstellung verwendet wird. CreateParentGroupInfoOrParentGroupInfo

CreateParentGroupInfoOrParentGroupInfo

Name Beschreibung Wert
id Die vollqualifizierte ID für die übergeordnete Verwaltungsgruppe. Beispiel: /providers/Microsoft.Management/managementGroups/000000000-0000-0000-00000-0000000000000 Zeichenfolge