Remove-AzPolicyEnrollment

Modul:
Az.Resources Module

Tar bort en försäkringsanmälan.

Syntax

DeleteByNameAndScope (Standard) 

Remove-AzPolicyEnrollment
    -Name <String>
    -Scope <String>
    [-Force]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DeleteById 

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

DeleteByInputObject 

Remove-AzPolicyEnrollment
    -InputObject <IPolicyEnrollment>
    [-Force]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cmdleten Remove-AzPolicyEnrollment tar bort en principregistrering med namnet och omfånget som den skapades i. Omfattningen av en policyregistrering är den del av dess ID som föregår '/providers/Microsoft.Authorization/policyEnrollments/{policyEnrollmentName}'.

Exempel

Exempel 1: Ta bort principregistrering efter namn och omfång

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Remove-AzPolicyEnrollment -Name 'PolicyEnrollment07' -Scope $ResourceGroup.ResourceId -Confirm

Det första kommandot hämtar en resursgrupp med namnet ResourceGroup11 med hjälp av cmdleten Get-AzResourceGroup. Kommandot lagrar objektet i variabeln $ResourceGroup. Det andra kommandot tar bort principregistreringen med namnet PolicyEnrollment07 i resursgruppens omfång. Egenskapen ResourceId för $ResourceGroup identifierar resursgruppen.

Exempel 2: Ta bort principregistrering efter ID

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$PolicyEnrollment = Get-AzPolicyEnrollment -Name 'PolicyEnrollment07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyEnrollment -Id $PolicyEnrollment.Id -Force

Det första kommandot hämtar en resursgrupp med namnet ResourceGroup11 och lagrar sedan objektet i variabeln $ResourceGroup. Det andra kommandot hämtar principregistreringen på resursgruppsnivå och lagrar den sedan i variabeln $PolicyEnrollment. Egenskapen ResourceId för $ResourceGroup identifierar resursgruppen. Det sista kommandot tar bort den principregistrering som ID-egenskapen för $PolicyEnrollment identifierar och kringgår bekräftelseprompten med parametern Force .

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Parameteregenskaper

Typ:PSObject
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzureRMContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Force

När $true hoppar du över bekräftelsemeddelanden

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Id

ID:t för principregistreringen som ska tas bort. Använd formatet {scope}/providers/Microsoft. Authorization/policyEnrollments/{policyEnrollmentName}'.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:PolicyEnrollmentId, ResourceId

Parameteruppsättningar

DeleteById
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-InputObject

Det principregistreringsobjekt som ska tas bort.

Parameteregenskaper

Typ:IPolicyEnrollment
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

DeleteByInputObject
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

Namnet på försäkringsanmälan.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:PolicyEnrollmentName

Parameteruppsättningar

DeleteByNameAndScope
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-PassThru

Returnerar sant när kommandot lyckas

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Scope

Omfånget för principregistreringen. Giltiga omfång är: hanteringsgrupp (format: '/providers/Microsoft. Management/managementGroups/{managementGroup}'), prenumeration (format: '/subscriptions/{subscriptionId}'), resursgrupp (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'), eller resurs (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}')

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

DeleteByNameAndScope
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

IPolicyEnrollment

String

Utdata

Boolean