New-AzureRmPolicySetDefinition

Referencia

Módulo:: AzureRM.Resources

Crea una definición de conjunto de directivas.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

New-AzureRmPolicySetDefinition
   -Name <String>
   [-DisplayName <String>]
   [-Description <String>]
   [-Metadata <String>]
   -PolicyDefinition <String>
   [-Parameter <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmPolicySetDefinition
   -Name <String>
   [-DisplayName <String>]
   [-Description <String>]
   [-Metadata <String>]
   -PolicyDefinition <String>
   [-Parameter <String>]
   -ManagementGroupName <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmPolicySetDefinition
   -Name <String>
   [-DisplayName <String>]
   [-Description <String>]
   [-Metadata <String>]
   -PolicyDefinition <String>
   [-Parameter <String>]
   -SubscriptionId <Guid>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-AzureRmPolicySetDefinition crea una definición de conjunto de directivas.

Ejemplos

Ejemplo 1: Crear una definición de conjunto de directivas mediante un archivo de conjunto de directivas

[
   {
      "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/2a0e14a6-b0a6-4fab-991a-187a4f81c498",
      "parameters": {
         "tagName": {
            "value": "Business Unit"
         },
         "tagValue": {
            "value": "Finance"
         }
      }
   },
   {
      "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/464dbb85-3d5f-4a1d-bb09-95a9b5dd19cf"
   }
]

PS C:\> New-AzureRmPolicySetDefinition -Name 'VMPolicyDefinition' -PolicyDefinition C:\VMPolicySet.json

Este comando crea una definición de conjunto de directivas denominada VMPolicyDefinition que contiene las definiciones de directiva especificadas en C:\VMPolicy.json. El contenido de ejemplo del VMPolicy.json se proporciona anteriormente.

Ejemplo 2: Creación de una definición de conjunto de directivas con parámetros

[
   {
      "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/2a0e14a6-b0a6-4fab-991a-187a4f81c498",
      "parameters": {
         "tagName": {
            "value": "Business Unit"
         },
         "tagValue": {
            "value": "[parameters('buTagValue')]"
         }
      }
   },
   {
      "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/464dbb85-3d5f-4a1d-bb09-95a9b5dd19cf"
   }
]

PS C:\> New-AzureRmPolicySetDefinition -Name 'VMPolicyDefinition' -PolicyDefinition C:\VMPolicySet.json -Parameter '{ "buTagValue": { "type": "string" } }'

Este comando crea una definición de conjunto de directivas con parámetros denominada VMPolicyDefinition que contiene las definiciones de directiva especificadas en C:\VMPolicy.json. El contenido de ejemplo del VMPolicy.json se proporciona anteriormente.

Parámetros

-ApiVersion

Cuando se establece, indica la versión de la API del proveedor de recursos que se va a usar. Si no se especifica, la versión de la API se determina automáticamente como la más reciente disponible.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Descripción de la definición del conjunto de directivas.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DisplayName

Nombre para mostrar de la definición del conjunto de directivas.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ManagementGroupName

Nombre del grupo de administración de la nueva definición del conjunto de directivas.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Metadata

Metadatos para la definición del conjunto de directivas. Puede ser una ruta de acceso a un nombre de archivo que contenga los metadatos o los metadatos como cadena.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Nombre de definición del conjunto de directivas.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Parameter

Declaración de parámetros para la definición del conjunto de directivas. Puede ser una ruta de acceso a un nombre de archivo que contenga la declaración de parámetros o la declaración de parámetros como cadena.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PolicyDefinition

Definición del conjunto de directivas. Puede ser una ruta de acceso a un nombre de archivo que contenga las definiciones de directiva o la definición del conjunto de directivas como cadena.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Pre

Cuando se establece, indica que el cmdlet debe usar versiones de API de versión preliminar al determinar automáticamente qué versión se va a usar.

Tipo:	SwitchParameter
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

Identificador de suscripción de la nueva definición del conjunto de directivas.

Tipo:	Nullable<T>[Guid]
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

String

Nullable<T>[[System.Guid, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Salidas

PSObject

Compartir a través de