Compartir a través de


Administración de Microsoft.ManagementGroups 2021-04-01

Definición de recursos de Bicep

El tipo de recurso managementGroups es un recurso de extensión, lo que significa que puede aplicarlo a otro recurso.

Use la scope propiedad de este recurso para establecer el ámbito de este recurso. Consulte Establecimiento del ámbito en los recursos de extensión en Bicep.

El tipo de recurso managementGroups se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Comentarios

Cuando se implemente en el ámbito del inquilino, no establezca la propiedad scope. Consulte Creación de grupos de administración con implementaciones de inquilinos en plantillas de Arm o archivo de Bicep.

Cuando se implementa en otros ámbitos, establezca la propiedad tenant() scope en para los archivos de Bicep o / para las plantillas de ARM. Consulte Creación de grupos de administración con implementaciones de grupos de administración en plantillas de Arm o archivo de Bicep.

Formato de los recursos

Para crear un recurso Microsoft.Management/managementGroups, agregue el siguiente bicep a la plantilla.

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

Valores de propiedad

managementGroups

Nombre Descripción Value
name El nombre del recurso string (obligatorio)
scope Use al crear un recurso de extensión en un ámbito diferente del ámbito de implementación. Para Bicep: tenant().
properties Las propiedades genéricas de un grupo de administración usadas durante la creación. CreateManagementGroupPropertiesOrManagementGroupProp...

CreateManagementGroupPropertiesOrManagementGroupProp...

Nombre Descripción Valor
detalles Detalles de un grupo de administración usado durante la creación. CreateManagementGroupDetailsOrManagementGroupDetails
DisplayName Nombre descriptivo del grupo de administración. Si no se pasa ningún valor, este campo se establecerá en el groupId. string

CreateManagementGroupDetailsOrManagementGroupDetails

Nombre Descripción Valor
primario (Opcional) Identificador del grupo de administración primario usado durante la creación. CreateParentGroupInfoOrParentGroupInfo

CreateParentGroupInfoOrParentGroupInfo

Nombre Descripción Value
id Identificador completo del grupo de administración primario. Por ejemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000 string

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Crear un nuevo grupo de administración

Implementación en Azure
Esta plantilla es una plantilla de nivel de inquilino que creará un nuevo grupo de administración.

Definición de recursos de plantilla de ARM

El tipo de recurso managementGroups es un recurso de extensión, lo que significa que puede aplicarlo a otro recurso.

Use la scope propiedad de este recurso para establecer el ámbito de este recurso. Consulte Establecimiento del ámbito en los recursos de extensión en plantillas de ARM.

El tipo de recurso managementGroups se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Comentarios

Cuando se implemente en el ámbito del inquilino, no establezca la propiedad scope. Consulte Creación de grupos de administración con implementaciones de inquilinos en plantillas de Arm o archivo de Bicep.

Cuando se implementa en otros ámbitos, establezca la propiedad tenant() scope en para los archivos de Bicep o / para las plantillas de ARM. Consulte Creación de grupos de administración con implementaciones de grupos de administración en plantillas de Arm o archivo de Bicep.

Formato de los recursos

Para crear un recurso Microsoft.Management/managementGroups, agregue el siguiente json a la plantilla.

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

Valores de propiedad

managementGroups

Nombre Descripción Value
type Tipo de recurso "Microsoft.Management/managementGroups"
apiVersion La versión de la API de recursos '2021-04-01'
name El nombre del recurso string (obligatorio)
scope Use al crear un recurso de extensión en un ámbito diferente del ámbito de implementación. Para JSON: /.
properties Las propiedades genéricas de un grupo de administración usadas durante la creación. CreateManagementGroupPropertiesOrManagementGroupProp...

CreateManagementGroupPropertiesOrManagementGroupProp...

Nombre Descripción Valor
detalles Detalles de un grupo de administración usado durante la creación. CreateManagementGroupDetailsOrManagementGroupDetails
DisplayName Nombre descriptivo del grupo de administración. Si no se pasa ningún valor, este campo se establecerá en el groupId. string

CreateManagementGroupDetailsOrManagementGroupDetails

Nombre Descripción Valor
primario (Opcional) Identificador del grupo de administración primario usado durante la creación. CreateParentGroupInfoOrParentGroupInfo

CreateParentGroupInfoOrParentGroupInfo

Nombre Descripción Value
id Identificador completo del grupo de administración primario. Por ejemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000 string

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Crear un nuevo grupo de administración

Implementación en Azure
Esta plantilla es una plantilla de nivel de inquilino que creará un nuevo grupo de administración.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso managementGroups es un recurso de extensión, lo que significa que puede aplicarlo a otro recurso.

Use la parent_id propiedad de este recurso para establecer el ámbito de este recurso.

El tipo de recurso managementGroups se puede implementar con operaciones destinadas a:

  • Inquilinos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Management/managementGroups, agregue el siguiente terraform a la plantilla.

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

Valores de propiedad

managementGroups

Nombre Descripción Value
type Tipo de recurso "Microsoft.Management/managementGroups@2021-04-01"
name El nombre del recurso string (obligatorio)
parent_id Identificador del recurso al que se va a aplicar este recurso de extensión. string (obligatorio)
properties Las propiedades genéricas de un grupo de administración usadas durante la creación. CreateManagementGroupPropertiesOrManagementGroupProp...

CreateManagementGroupPropertiesOrManagementGroupProp...

Nombre Descripción Valor
detalles Detalles de un grupo de administración usado durante la creación. CreateManagementGroupDetailsOrManagementGroupDetails
DisplayName Nombre descriptivo del grupo de administración. Si no se pasa ningún valor, este campo se establecerá en el groupId. string

CreateManagementGroupDetailsOrManagementGroupDetails

Nombre Descripción Valor
primario (Opcional) Identificador del grupo de administración primario usado durante la creación. CreateParentGroupInfoOrParentGroupInfo

CreateParentGroupInfoOrParentGroupInfo

Nombre Descripción Value
id Identificador completo del grupo de administración primario. Por ejemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000 string