New-AzPolicySetDefinition

  • Başvuru
Modül:
Az.Resources

İlke kümesi tanımı oluşturur.

Syntax

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

Description

New-AzPolicySetDefinition cmdlet'i bir ilke kümesi tanımı oluşturur.

Örnekler

Örnek 1: İlke kümesi dosyasını kullanarak meta verilerle ilke kümesi tanımı oluşturma

<#[
   {
      "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"
   }
]#>
New-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -Metadata '{"category":"Virtual Machine"}' -PolicyDefinition C:\VMPolicySet.json

Bu komut, kategorisinin C:\VMPolicy.json'de belirtilen ilke tanımlarını içeren "Sanal Makine" olduğunu belirten meta verilerle VMPolicySetDefinition adlı bir ilke kümesi tanımı oluşturur. VMPolicy.json örnek içeriği yukarıda verilmiştir.

Örnek 2: Parametreli ilke kümesi tanımı oluşturma

<#[
   {
      "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"
   }
]#>
New-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -PolicyDefinition C:\VMPolicySet.json -Parameter '{ "buTagValue": { "type": "string" } }'

Bu komut, C:\VMPolicy.json içinde belirtilen ilke tanımlarını içeren VMPolicySetDefinition adlı parametreli bir ilke kümesi tanımı oluşturur. VMPolicy.json örnek içeriği yukarıda verilmiştir.

Örnek 3: İlke tanımı gruplarıyla ilke kümesi tanımı oluşturma

<#[
   {
      "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/2a0e14a6-b0a6-4fab-991a-187a4f81c498",
      "groupNames": [ "group1" ]
   },
   {
      "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/464dbb85-3d5f-4a1d-bb09-95a9b5dd19cf",
      "groupNames": [ "group2" ]
   }
]#>
$groupsJson = ConvertTo-Json @{ name = "group1" }, @{ name = "group2" }
New-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -GroupDefinition $groupsJson -PolicyDefinition C:\VMPolicySet.json

Bu komut, C:\VMPolicy.json'de belirtilen ilke tanımlarının gruplandırılmasıyla VMPolicySetDefinition adlı bir ilke kümesi tanımı oluşturur. VMPolicy.json örnek içeriği yukarıda verilmiştir.

Parametreler

-ApiVersion

Ayarlandığında, kullanılacak kaynak sağlayıcısı API'sinin sürümünü gösterir. Belirtilmezse, API sürümü otomatik olarak en son kullanılabilir sürüm olarak belirlenir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

İlke kümesi tanımının açıklaması.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplayName

İlke kümesi tanımının görünen adı.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-GroupDefinition

Yeni ilke kümesi tanımı için ilke tanımı grupları. Bu, grupları içeren bir dosyanın yolu veya JSON dizesi olarak gruplar olabilir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ManagementGroupName

Yeni ilke kümesi tanımının yönetim grubunun adı.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Metadata

İlke kümesi tanımının meta verileri. Bu, meta verileri içeren bir dosya adının yolu veya JSON dizesi olarak meta veriler olabilir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

İlke kümesi tanım adı.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Parameter

İlke kümesi tanımı için parametre bildirimi. Bu, parametre bildirimini içeren bir dosya adının yolu veya JSON dizesi olarak parametre bildirimi olabilir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PolicyDefinition

İlke tanımları. Bu, ilke tanımlarını içeren bir dosya adının yolu veya JSON dizesi olarak ilke tanımları olabilir.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Pre

Ayarlandığında, cmdlet'in hangi sürümün kullanılacağını otomatik olarak belirlerken yayın öncesi API sürümlerini kullanması gerektiğini belirtir.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Yeni ilke kümesi tanımının abonelik kimliği.

Type:Nullable<T>[Guid]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

String

Nullable<T>[[System.Guid, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Çıkışlar

PSObject