Udostępnij przez


Microsoft.ManagementGroups

Uwagi

Po wdrożeniu w zakresie dzierżawy nie należy ustawiać właściwości zakresu. Zobacz tworzenie grup zarządzania przy użyciu wdrożeń dzierżawy w pliku Bicep lub szablonów usługi ARM .

Po wdrożeniu w innych zakresach ustaw właściwość zakresu na tenant() dla plików Bicep lub / dla szablonów usługi ARM. Zobacz tworzenie grup zarządzania przy użyciu wdrożeń grup zarządzania w pliku Bicep lub szablonach usługi ARM .

Definicja zasobu Bicep

Typ zasobu managementGroups można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Management/managementGroups, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.Management/managementGroups@2024-02-01-preview' = {
  scope: resourceSymbolicName or scope
  name: 'string'
  properties: {
    details: {
      parent: {
        id: 'string'
      }
    }
    displayName: 'string'
  }
}

Wartości właściwości

Microsoft.Management/managementGroups

Nazwa Opis Wartość
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Ogólne właściwości grupy zarządzania używanej podczas tworzenia. CreateManagementGroupPropertiesOrManagementGroupProperties
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.

CreateManagementGroupDetailsOrManagementGroupDetails

Nazwa Opis Wartość
nadrzędny (Opcjonalnie) Identyfikator nadrzędnej grupy zarządzania używanej podczas tworzenia. CreateParentGroupInfoOrParentGroupInfo

CreateManagementGroupPropertiesOrManagementGroupProperties

Nazwa Opis Wartość
Szczegóły Szczegóły grupy zarządzania używanej podczas tworzenia. createManagementGroupDetailsOrManagementGroupDetails
nazwa wyświetlana Przyjazna nazwa grupy zarządzania. Jeśli nie przekazano żadnej wartości, to to pole zostanie ustawione na groupId. ciąg

CreateParentGroupInfoOrParentGroupInfo

Nazwa Opis Wartość
id W pełni kwalifikowany identyfikator nadrzędnej grupy zarządzania. Na przykład /providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-0000000000000 ciąg

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
Grupa zarządzania Moduł zasobów AVM dla grupy zarządzania

Definicja zasobu szablonu usługi ARM

Typ zasobu managementGroups można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Management/managementGroups, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.Management/managementGroups",
  "apiVersion": "2024-02-01-preview",
  "name": "string",
  "properties": {
    "details": {
      "parent": {
        "id": "string"
      }
    },
    "displayName": "string"
  }
}

Wartości właściwości

Microsoft.Management/managementGroups

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API "2024-02-01-preview"
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Ogólne właściwości grupy zarządzania używanej podczas tworzenia. CreateManagementGroupPropertiesOrManagementGroupProperties
typ Typ zasobu "Microsoft.Management/managementGroups"

CreateManagementGroupDetailsOrManagementGroupDetails

Nazwa Opis Wartość
nadrzędny (Opcjonalnie) Identyfikator nadrzędnej grupy zarządzania używanej podczas tworzenia. CreateParentGroupInfoOrParentGroupInfo

CreateManagementGroupPropertiesOrManagementGroupProperties

Nazwa Opis Wartość
Szczegóły Szczegóły grupy zarządzania używanej podczas tworzenia. createManagementGroupDetailsOrManagementGroupDetails
nazwa wyświetlana Przyjazna nazwa grupy zarządzania. Jeśli nie przekazano żadnej wartości, to to pole zostanie ustawione na groupId. ciąg

CreateParentGroupInfoOrParentGroupInfo

Nazwa Opis Wartość
id W pełni kwalifikowany identyfikator nadrzędnej grupy zarządzania. Na przykład /providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-0000000000000 ciąg

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Szablon Opis
tworzenie nowej grupy zarządzania

wdrażanie w usłudze Azure
Ten szablon jest szablonem na poziomie dzierżawy, który utworzy nową grupę zarządzania.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu managementGroups można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Management/managementGroups, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Management/managementGroups@2024-02-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      details = {
        parent = {
          id = "string"
        }
      }
      displayName = "string"
    }
  }
}

Wartości właściwości

Microsoft.Management/managementGroups

Nazwa Opis Wartość
nazwa Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
Właściwości Ogólne właściwości grupy zarządzania używanej podczas tworzenia. CreateManagementGroupPropertiesOrManagementGroupProperties
typ Typ zasobu "Microsoft.Management/managementGroups@2024-02-01-preview"

CreateManagementGroupDetailsOrManagementGroupDetails

Nazwa Opis Wartość
nadrzędny (Opcjonalnie) Identyfikator nadrzędnej grupy zarządzania używanej podczas tworzenia. CreateParentGroupInfoOrParentGroupInfo

CreateManagementGroupPropertiesOrManagementGroupProperties

Nazwa Opis Wartość
Szczegóły Szczegóły grupy zarządzania używanej podczas tworzenia. createManagementGroupDetailsOrManagementGroupDetails
nazwa wyświetlana Przyjazna nazwa grupy zarządzania. Jeśli nie przekazano żadnej wartości, to to pole zostanie ustawione na groupId. ciąg

CreateParentGroupInfoOrParentGroupInfo

Nazwa Opis Wartość
id W pełni kwalifikowany identyfikator nadrzędnej grupy zarządzania. Na przykład /providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-0000000000000 ciąg