Delen via


Remove-CMSecurityRole

SYNOPSIS

Hiermee verwijdert u aangepaste beveiligingsrollen Configuration Manager.

SYNTAX

SearchByValueMandatory (standaard)

Remove-CMSecurityRole [-Force] -InputObject <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByIdMandatory

Remove-CMSecurityRole [-Force] -Id <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

SearchByNameMandatory

Remove-CMSecurityRole [-Force] -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DESCRIPTION

De cmdlet Remove-CMSecurityRole verwijdert aangepaste beveiligingsrollen uit Configuration Manager. Geef de naam of id op van een beveiligingsrol die u wilt verwijderen of gebruik de cmdlet Get-CMSecurityRole om er een te verkrijgen.

Configuration Manager gebruikt beveiligingsrollen, samen met beveiligingsbereiken en verzamelingen, voor het definiëren van een beheerbereik voor elke gebruiker met beheerdersrol. Configuration Manager biedt verschillende ingebouwde beveiligingsrollen. Als u een aangepaste beveiligingsrol wilt maken, kopieert u een bestaande beveiligingsrol en wijzigt u vervolgens de kopie. U kunt een beveiligingsrol kopiëren met behulp van de Copy-CMSecurityRole cmdlet .

U kunt de cmdlet Remove-CMSecurityRole oude, onnodige aangepaste beveiligingsrollen te verwijderen. U kunt ingebouwde beveiligingsrollen niet verwijderen. Elke gebruiker met beheerders beheerdersrol moet ten minste één beveiligingsrol hebben. Voordat u een beveiligingsrol verwijdert, moet u ervoor zorgen dat elke gebruiker een rol heeft naast de rol die u verwijdert.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een beveiligingsrol verwijderen met behulp van een naam

PS XYZ:\> Remove-CMSecurityRole -Name "MainSecurityRole" -Force

Met deze opdracht verwijdert u een beveiligingsrol met de naam MainSecurityRole uit Configuration Manager. De opdracht maakt gebruik van de parameter Force, zodat u niet om bevestiging wordt gevraagd.

Voorbeeld 2: beveiligingsrollen verwijderen met behulp van een variabele

PS XYZ:\> $Roles = Get-CMSecurityRole -Name *Role
PS XYZ:\> Remove-CMSecurityRole -SecurityRole $Roles

De eerste opdracht maakt gebruik van de cmdlet Get-CMSecurityRole om elke beveiligingsrol op te halen die een naam heeft die eindigt op Rol. Het slaat ze op in de $Roles variabele.

Met de tweede opdracht wordt elke beveiligingsrol verwijderd die is opgeslagen in de $Roles variabele.

PARAMETERS

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Force

Dwingt de opdracht uit te voeren zonder te vragen om bevestiging van de gebruiker.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Hiermee geeft u een matrix met ID's van beveiligingsrollen op.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: RoleId

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

-InputObject

Hiermee geeft u een beveiligingsrolobject. Als u een beveiligingsrolobject wilt verkrijgen, gebruikt u de cmdlet Get-CMSecurityRole.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Hiermee geeft u een matrix met namen van beveiligingsrollen.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases: RoleName

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

Copy-CMSecurityRole

Export-CMSecurityRole

Get-CMSecurityRole

Import-CMSecurityRole

Set-CMSecurityRole