Delen via


Remove-CMObjectSecurityScope

SYNOPSIS

Hiermee verwijdert u een beveiligingsbereik van een Configuration Manager-object.

SYNTAX

ByValue (standaard)

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

ById

Remove-CMObjectSecurityScope [-Force] -Id <String> -InputObject <IResultObject[]> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

ByName

Remove-CMObjectSecurityScope [-Force] -InputObject <IResultObject[]> [-Name] <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

De cmdlet Remove-CMObjectSecurityScope verwijdert een beveiligingsbereik van een Configuration Manager object.

Notitie

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

EXAMPLES

Voorbeeld 1: Een beveiligingsbereik verwijderen uit toepassingsobjecten met behulp van de pijplijn

PS XYZ:\> $Scope = Get-CMSecurityScope -Name "Scope1"
PS XYZ:\> Get-CMApplication -Name "Application*" | Remove-CMObjectSecurityScope -Scope $Scope -Force

De eerste opdracht haalt het beveiligingsbereikobject met de naam Scope1 op en slaat het object op in de $Scope variabele.

Met de tweede opdracht worden alle toepassingsobjecten met een naam die begint met Application en die de pijplijnoperator gebruikt om de objecten door te geven aan Remove-CMObjectSecurityScope. Remove-CMObjectSecurityScope verwijdert het beveiligingsbereik dat is opgeslagen in $Scope van elk van de toepassingsobjecten. De parameter Force geeft aan dat de gebruiker niet wordt gevraagd voordat het beveiligingsbereik wordt verwijderd.

Voorbeeld 2: Een beveiligingsbereik verwijderen uit toepassingsobjecten

PS XYZ:\> Remove-CMObjectSecurityScope -InputObject (Get-CMApplication -Name "Application*") -Name "Scope1" -Force

Met deze opdracht worden alle toepassingsobjecten met een naam die begint met Toepassing, en wordt het beveiligingsbereik met de naam Scope1 uit elk toepassingsobject verwijderd. De parameter Force geeft aan dat de gebruiker niet wordt gevraagd voordat het beveiligingsbereik wordt verwijderd.

Voorbeeld 3: Een nieuw beveiligingsbereik toevoegen en vervolgens alle andere verwijderen uit het toepassingsobject

#Get Desired Security Scope
$ScopeName = "Team ABC"
$TeamABCScope = Get-CMSecurityScope | Where-Object {$_.CategoryName -eq $ScopeName}

#Get Object to add scope too
$Application = Get-CMApplication -Name "Edge Enterprise Stable"

#Add Scope to object
Add-CMObjectSecurityScope -InputObject $Application -Scope $TeamABCScope

#Get Scopes on Application that're are NOT the one you just added, then cycle through and remove.
foreach ($ExtraScope in (Get-CMObjectSecurityScope -InputObject $Application | Where-Object {$_.CategoryName -ne $ScopeName}))
    {
    Remove-CMObjectSecurityScope -InputObject $Application -Scope $ExtraScope -Force
    }

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 de id van een beveiligingsbereik.

Type: String
Parameter Sets: ById
Aliases: SecurityScopeId

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

-InputObject

Hiermee geeft u een matrix van Configuration Manager objecten die zijn gekoppeld aan een beveiligingsbereik.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-Name

Hiermee geeft u de naam van een beveiligingsbereik.

Type: String
Parameter Sets: ByName
Aliases: SecurityScopeName

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

-Bereik

Hiermee geeft u een matrix van beveiligingsbereiken.

Type: IResultObject[]
Parameter Sets: ByValue
Aliases: SecurityScope, SecuredCategory, Scopes, SecurityScopes, SecuredCategories

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

-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

Add-CMObjectSecurityScope

Get-CMObjectSecurityScope

Get-CMSecurityScope

Set-CMObjectSecurityScope