Remove-CMSecurityRole
SYNOPSIS
Tar bort anpassade säkerhetsroller från Konfigurationshanteraren.
SYNTAX
SearchByValueMandatory (standard)
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
Cmdleten Remove-CMSecurityRole tar bort anpassade säkerhetsroller från Konfigurationshanteraren. Ange namnet eller ID:t för en säkerhetsroll som du vill ta bort eller använd cmdleten Get-CMSecurityRole för att hämta en.
Konfigurationshanteraren använder säkerhetsroller, tillsammans med säkerhetsomfattningar och samlingar, för att definiera en administrativ omfattning för varje administrativ användare. Konfigurationshanteraren har flera inbyggda säkerhetsroller. Om du vill skapa en anpassad säkerhetsroll kopierar du en befintlig säkerhetsroll och ändrar sedan kopian. Du kan kopiera en säkerhetsroll med hjälp av Copy-CMSecurityRole cmdlet.
Du kan använda Remove-CMSecurityRole cmdlet för att ta bort gamla, anpassade säkerhetsroller som inte används. Du kan inte ta bort inbyggda säkerhetsroller. Varje administrativ användare måste ha minst en säkerhetsroll. Innan du tar bort en säkerhetsroll kontrollerar du att alla användare har en roll utöver den som du tar bort.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Ta bort en säkerhetsroll med hjälp av ett namn
PS XYZ:\> Remove-CMSecurityRole -Name "MainSecurityRole" -Force
Det här kommandot tar bort en säkerhetsroll med namnet MainSecurityRole från Konfigurationshanteraren. Kommandot använder force-parametern, så det uppmanar dig inte att bekräfta.
Exempel 2: Ta bort säkerhetsroller med hjälp av en variabel
PS XYZ:\> $Roles = Get-CMSecurityRole -Name *Role
PS XYZ:\> Remove-CMSecurityRole -SecurityRole $Roles
Det första kommandot använder cmdleten Get-CMSecurityRole för att hämta varje säkerhetsroll som har ett namn som slutar med Roll. De lagras i $Roles variabeln.
Det andra kommandot tar bort varje säkerhetsroll som lagras i $Roles variabeln.
PARAMETERS
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force
Tvingar kommandot att köras utan att fråga efter användarens bekräftelse.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Anger en matris med SÄKERHETSROLLER.
Type: String
Parameter Sets: SearchByIdMandatory
Aliases: RoleId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Anger ett säkerhetsrollobjekt. Om du vill hämta ett säkerhetsrollobjekt använder du cmdleten 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
Anger en matris med namn på säkerhetsroller.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: RoleName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.