Dela via


Set-CMSecurityScope

SYNOPSIS

Anger en säkerhetsomfattning.

SYNTAX

SetByValue (standard)

Set-CMSecurityScope [-Description <String>] -InputObject <IResultObject> [-NewName <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetById

Set-CMSecurityScope [-Description <String>] -Id <String> [-NewName <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetByName

Set-CMSecurityScope [-Description <String>] -Name <String> [-NewName <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Cmdleten Set-CMSecurityScope ändrar konfigurationsinställningarna för en säkerhetsomfattning.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Hämta en säkerhetsomfattning och uppdatera dess namn

PS XYZ:\> $Scope = Get-CMSecurityScope -Name "Scope"
PS XYZ:\> Set-CMSecurityScope -InputObject $Scope -NewName "newScope"

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

Det andra kommandot ändrar namnet på säkerhetsomfattningen som lagras i $Scope till newScope.

Exempel 2: Skicka en säkerhetsomfattning via pipelinen och uppdatera dess namn

PS XYZ:\> Get-CMSecurityScope -Name "Scope" | Set-CMSecurityScope -NewName "newScope"

Det här kommandot hämtar säkerhetsomfattningsobjektet med namnet Scope och använder pipelineoperatorn för att skicka objektet till Set-CMSecurityScope, som ändrar namnet på säkerhetsomfattningen till newScope.

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

-Beskrivning

Anger en beskrivning av säkerhetsomfattningen.

Type: String
Parameter Sets: (All)
Aliases: CategoryDescription

Required: False
Position: Named
Default value: None
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

-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: SetById
Aliases: CategoryId

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

-InputObject

Anger ett säkerhetsomfattningsobjekt. Om du vill hämta ett säkerhetsomfattningsobjekt använder du cmdleten Get-CMSecurityScope.

Type: IResultObject
Parameter Sets: SetByValue
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: SetByName
Aliases: CategoryName

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

-NewName

Anger ett nytt namn för säkerhetsomfattningen.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
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

Get-CMSecurityScope

New-CMSecurityScope

Remove-CMSecurityScope

Remove-CMSecurityScopeFromAdministrativeUser