Set-AzureRmPolicySetDefinition

Referencia

Módulo:: AzureRM.Resources

Modifica 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

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

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

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

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

Description

El cmdlet Set-AzureRmPolicySetDefinition modifica una definición de directiva.

Ejemplos

Ejemplo 1: Actualización de la descripción de una definición de conjunto de directivas

PS C:\> $PolicySetDefinition = Get-AzureRmPolicySetDefinition -ResourceId '/subscriptions/mySub/Microsoft.Authorization/policySetDefinitions/myPSSetDefinition'
PS C:\> Set-AzureRmPolicySetDefinition -Id $PolicySetDefinition.ResourceId -Description 'Updated policy to not allow virtual machine creation'

El primer comando obtiene una definición de conjunto de directivas mediante el cmdlet Get-AzureRmPolicySetDefinition. El comando almacena ese objeto en la variable $PolicySetDefinition. El segundo comando actualiza la descripción de la definición del conjunto de directivas identificada por la propiedad ResourceId de $PolicySetDefinition.

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

-Id

Identificador de definición de directiva completo, incluida la suscripción. Por ejemplo, /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}

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

-ManagementGroupName

Nombre del grupo de administración de la definición del conjunto de directivas que se va a actualizar.

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

-Metadata

Metadatos de la definición actualizada del conjunto de directivas. Puede ser una ruta de acceso a un nombre de archivo que contenga los metadatos o los metadatos como una 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 de la definición actualizada del conjunto de directivas. Puede ser una ruta de acceso a un nombre de archivo o URI que contiene la declaración de parámetros o la declaración de parámetros como una 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:	False
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 definición del conjunto de directivas que se va a actualizar.

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