Dela via


Remove-CMObjectSecurityScope

SYNOPSIS

Tar bort en säkerhetsomfattning från Konfigurationshanteraren objekt.

SYNTAX

ByValue (standard)

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

Cmdleten Remove-CMObjectSecurityScope tar bort en säkerhetsomfattning från Konfigurationshanteraren objekt.

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äkerhetsomfattning från programobjekt med hjälp av pipelinen

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

Det första kommandot hämtar säkerhetsomfattningsobjektet med namnet Scope1 och lagrar objektet i $Scope variabeln.

Det andra kommandot hämtar alla programobjekt som har ett namn som börjar med Application och använder pipelineoperatorn för att skicka objekten till Remove-CMObjectSecurityScope. Remove-CMObjectSecurityScope tar bort säkerhetsomfattningen som lagras i $Scope från vart och ett av programobjekten. Parametern Force anger att användaren inte tillfrågas innan säkerhetsomfattningen tas bort.

Exempel 2: Ta bort en säkerhetsomfattning från programobjekt

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

Det här kommandot hämtar alla programobjekt som har ett namn som börjar med Program och tar bort säkerhetsomfattningen med namnet Scope1 från varje programobjekt. Parametern Force anger att användaren inte tillfrågas innan säkerhetsomfattningen tas bort.

Exempel 3: Lägg till en ny säkerhetsomfattning och ta sedan bort alla andra från programobjektet

#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

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 ID för en säkerhetsomfattning.

Type: String
Parameter Sets: ById
Aliases: SecurityScopeId

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

-InputObject

Anger en matris med Konfigurationshanteraren objekt som är associerade med en säkerhetsomfattning.

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

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

-Name

Anger namnet på en säkerhetsomfattning.

Type: String
Parameter Sets: ByName
Aliases: SecurityScopeName

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

-Omfång

Anger en matris med säkerhetsomfattningar.

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

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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

OUTPUTS

System.Object

ANTECKNINGAR

Add-CMObjectSecurityScope

Get-CMObjectSecurityScope

Get-CMSecurityScope

Set-CMObjectSecurityScope