Remove-AzPolicySetDefinition

Módulo:

Az.Resources Module

Esta operação elimina a definição do conjunto de políticas na subscrição dada com o nome próprio.

Sintaxe

Name (Predefinição)

Remove-AzPolicySetDefinition
    -Name <String>
    [-Force]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ManagementGroupName

Remove-AzPolicySetDefinition
    -Name <String>
    -ManagementGroupName <String>
    [-Force]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SubscriptionId

Remove-AzPolicySetDefinition
    -Name <String>
    -SubscriptionId <String>
    [-Force]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Id

Remove-AzPolicySetDefinition
    -Id <String>
    [-Force]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObject

Remove-AzPolicySetDefinition
    -InputObject <IPolicyIdentity>
    [-Force]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrição

Esta operação elimina a definição do conjunto de políticas na subscrição dada com o nome próprio.

Exemplos

Exemplo 1: Remover a definição do conjunto de políticas pelo nome

Remove-AzPolicySetDefinition -Name 'myPSSetDefinition'

Este comando remove a definição especificada do conjunto de políticas.

Exemplo 2: Remover definição de conjunto de políticas por ID de recurso

$PolicySetDefinition = Get-AzPolicySetDefinition -ResourceId '/subscriptions/mySub/Microsoft.Authorization/policySetDefinitions/myPSSetDefinition'
Remove-AzPolicySetDefinition -Id $PolicySetDefinition.Id -Force

O primeiro comando obtém uma definição de conjunto de políticas usando o cmdlet Get-AzPolicySetDefinition. O comando armazena-o na variável $PolicySetDefinition. O segundo comando remove a definição do conjunto de políticas identificada pela propriedade ResourceId do $PolicySetDefinition.

Exemplo 3: Remover a versão da definição do conjunto de políticas pelo nome

Remove-AzPolicySetDefinition -Name 'myPSSetDefinition' -Version '1.0.1' -PassThru

Este comando remove a versão especificada da definição do conjunto de políticas e retornará verdadeiro quando o comando for bem-sucedido.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Cf.

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-DefaultProfile

O parâmetro DefaultProfile não é funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Propriedades dos parâmetros

Tipo:	PSObject
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	AzureRMContext, AzureCredential

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Force

Quando $true, ignore os prompts de confirmação

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Id

O ID completo da definição do conjunto de políticas a obter.

Propriedades dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	ResourceId

Conjuntos de parâmetros

Id

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-InputObject

Parâmetro de identidade Para construir, consulte a seção NOTAS para propriedades INPUTOBJECT e crie uma tabela de hash.

Propriedades dos parâmetros

Tipo:	IPolicyIdentity
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

InputObject

Posto:	Named
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-ManagementGroupName

O nome do grupo de gerenciamento.

Propriedades dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

ManagementGroupName

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Name

O nome da definição do conjunto de políticas a obter.

Propriedades dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	PolicySetDefinitionName

Conjuntos de parâmetros

Name

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-PassThru

Retorna true quando o comando é bem-sucedido

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-SubscriptionId

O ID da assinatura de destino.

Propriedades dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

SubscriptionId

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Version

A versão de definição do conjunto de políticas no formato #.#.#.

Propriedades dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	PolicySetDefinitionVersion

Conjuntos de parâmetros

Name

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

ManagementGroupName

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

SubscriptionId

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

Id

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Wi

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

IPolicyIdentity

String

Saídas

Boolean