Compartilhar via


Grupos de gerenciamento microsoft.management

Observações

Quando implantado no escopo do locatário, não defina a propriedade de escopo. Consulte criar grupos de gerenciamento com implantações de locatário em de arquivos Bicep ou modelos do ARM.

Quando implantado em outros escopos, defina a propriedade de escopo como tenant() para arquivos Bicep ou / para modelos do ARM. Consulte criar grupos de gerenciamento com implantações de grupo de gerenciamento em de arquivos Bicep ou modelos do ARM.

Definição de recurso do Bicep

O tipo de recurso managementGroups pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Management/managementGroups, adicione o Bicep a seguir ao seu modelo.

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

Valores de propriedade

Microsoft.Management/managementGroups

Nome Descrição Valor
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades As propriedades genéricas de um grupo de gerenciamento usadas durante a criação. CreateManagementGroupPropertiesOrManagementGroupProperties
escopo Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .

CreateManagementGroupDetailsOrManagementGroupDetails

Nome Descrição Valor
pai (Opcional) A ID do grupo de gerenciamento pai usado durante a criação. CreateParentGroupInfoOrParentGroupInfo

CreateManagementGroupPropertiesOrManagementGroupProperties

Nome Descrição Valor
Detalhes Os detalhes de um grupo de gerenciamento usado durante a criação. CreateManagementGroupDetailsOrManagementGroupDetails
nome de exibição O nome amigável do grupo de gerenciamento. Se nenhum valor for passado, esse campo será definido como groupId. cadeia

CreateParentGroupInfoOrParentGroupInfo

Nome Descrição Valor
id A ID totalmente qualificada para o grupo de gerenciamento pai. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000 cadeia

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo Descrição
do Grupo de Gerenciamento Módulo de recurso AVM para grupo de gerenciamento

Definição de recurso de modelo do ARM

O tipo de recurso managementGroups pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Management/managementGroups, adicione o JSON a seguir ao seu modelo.

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

Valores de propriedade

Microsoft.Management/managementGroups

Nome Descrição Valor
apiVersion A versão da API '2024-02-01-preview'
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades As propriedades genéricas de um grupo de gerenciamento usadas durante a criação. CreateManagementGroupPropertiesOrManagementGroupProperties
tipo O tipo de recurso 'Microsoft.Management/managementGroups'

CreateManagementGroupDetailsOrManagementGroupDetails

Nome Descrição Valor
pai (Opcional) A ID do grupo de gerenciamento pai usado durante a criação. CreateParentGroupInfoOrParentGroupInfo

CreateManagementGroupPropertiesOrManagementGroupProperties

Nome Descrição Valor
Detalhes Os detalhes de um grupo de gerenciamento usado durante a criação. CreateManagementGroupDetailsOrManagementGroupDetails
nome de exibição O nome amigável do grupo de gerenciamento. Se nenhum valor for passado, esse campo será definido como groupId. cadeia

CreateParentGroupInfoOrParentGroupInfo

Nome Descrição Valor
id A ID totalmente qualificada para o grupo de gerenciamento pai. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000 cadeia

Exemplos de uso

Modelos de início rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Modelo Descrição
criar um novo grupo de gerenciamento

Implantar no Azure
Esse modelo é um modelo de nível de locatário que criará um novo grupo de gerenciamento.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso managementGroups pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Management/managementGroups, adicione o Terraform a seguir ao seu modelo.

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"
    }
  }
}

Valores de propriedade

Microsoft.Management/managementGroups

Nome Descrição Valor
nome O nome do recurso cadeia de caracteres (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. cadeia de caracteres (obrigatório)
Propriedades As propriedades genéricas de um grupo de gerenciamento usadas durante a criação. CreateManagementGroupPropertiesOrManagementGroupProperties
tipo O tipo de recurso "Microsoft.Management/managementGroups@2024-02-01-preview"

CreateManagementGroupDetailsOrManagementGroupDetails

Nome Descrição Valor
pai (Opcional) A ID do grupo de gerenciamento pai usado durante a criação. CreateParentGroupInfoOrParentGroupInfo

CreateManagementGroupPropertiesOrManagementGroupProperties

Nome Descrição Valor
Detalhes Os detalhes de um grupo de gerenciamento usado durante a criação. CreateManagementGroupDetailsOrManagementGroupDetails
nome de exibição O nome amigável do grupo de gerenciamento. Se nenhum valor for passado, esse campo será definido como groupId. cadeia

CreateParentGroupInfoOrParentGroupInfo

Nome Descrição Valor
id A ID totalmente qualificada para o grupo de gerenciamento pai. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000 cadeia