Partager via


New-AzureRmPolicySetDefinition

Crée une définition d’ensemble de stratégies.

Avertissement

Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module 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

L’applet de commande New-AzureRmPolicySetDefinition crée une définition d’ensemble de stratégies.

Exemples

Exemple 1 : Créer une définition de jeu de stratégies à l’aide d’un fichier de jeu de stratégies

[
   {
      "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

Cette commande crée une définition de jeu de stratégies nommée VMPolicyDefinition qui contient les définitions de stratégie spécifiées dans C :\VMPolicy.json. L’exemple de contenu de la VMPolicy.json est fourni ci-dessus.

Exemple 2 : Créer une définition de jeu de stratégies paramétrable

[
   {
      "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" } }'

Cette commande crée une définition de jeu de stratégies paramétrable nommée VMPolicyDefinition qui contient les définitions de stratégie spécifiées dans C :\VMPolicy.json. L’exemple de contenu de la VMPolicy.json est fourni ci-dessus.

Paramètres

-ApiVersion

Quand elle est définie, indique la version de l’API du fournisseur de ressources à utiliser. Si elle n’est pas spécifiée, la version de l’API est automatiquement déterminée comme la dernière version disponible.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Description de la définition du jeu de stratégies.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplayName

Nom complet de la définition du jeu de stratégies.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-ManagementGroupName

Nom du groupe d’administration de la nouvelle définition de jeu de stratégies.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-Metadata

Métadonnées pour la définition du jeu de stratégies. Il peut s’agir d’un chemin d’accès à un nom de fichier contenant les métadonnées, ou des métadonnées sous forme de chaîne

Type:String
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Nom de définition du jeu de stratégies.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-Parameter

Déclaration de paramètres pour la définition du jeu de stratégies. Il peut s’agir d’un chemin d’accès à un nom de fichier contenant la déclaration de paramètres ou de la déclaration de paramètres sous forme de chaîne.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-PolicyDefinition

Définition du jeu de stratégies. Il peut s’agir d’un chemin d’accès à un nom de fichier contenant les définitions de stratégie ou de la définition de jeu de stratégies sous forme de chaîne.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-Pre

Quand elle est définie, indique que l’applet de commande doit utiliser des versions d’API en préversion lors de la détermination automatique de la version à utiliser.

Type:SwitchParameter
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

ID d’abonnement de la nouvelle définition de jeu de stratégies.

Type:Nullable<T>[Guid]
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

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

Sorties

PSObject