Sdílet prostřednictvím

Set-CMConfigurationItem

  • Článek

SYNOPSIS

Změní nastavení pro Správce konfigurace položky konfigurace.

SYNTAX

SetByIdMandatory (výchozí)

Set-CMConfigurationItem [-AddCategory <String[]>] [-Description <String>] [-Digest <ConfigurationItem>]
 [-DigestPath <String>] [-DigestXml <String>] [-Id] <Int32> [-NewName <String>] [-PassThru]
 [-RemoveCategory <String[]>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SetByNameMandatory

Set-CMConfigurationItem [-AddCategory <String[]>] [-Description <String>] [-Digest <ConfigurationItem>]
 [-DigestPath <String>] [-DigestXml <String>] [-Name] <String> [-NewName <String>] [-PassThru]
 [-RemoveCategory <String[]>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SetByValueMandatory

Set-CMConfigurationItem [-AddCategory <String[]>] [-Description <String>] [-Digest <ConfigurationItem>]
 [-DigestPath <String>] [-DigestXml <String>] [-InputObject] <IResultObject> [-NewName <String>] [-PassThru]
 [-RemoveCategory <String[]>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

Rutina Set-CMConfigurationItem mění nastavení pro Správce konfigurace položky konfigurace.

Položky konfigurace obsahují jedno nebo více nastavení spolu s pravidly dodržování předpisů. Položky obvykle definují jednotku konfigurace, kterou chcete monitorovat. Další informace o položkách konfigurace najdete v tématu Úvod do dodržování předpisů Nastavení v Správce konfigurace.

Poznámka

Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: Změna názvu položky konfigurace

PS XYZ:\> Set-CMConfigurationItem -Name "CITest" -NewName "CITest01"

Tento příkaz změní název položky konfigurace s názvem CITest na CITest01.

Příklad 2: Nastavení položky

PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction AddMembership -SecurityScopeName "DefaultScope"

Tento příkaz nastaví akci oboru zabezpečení na AddMembership a název oboru zabezpečení na DefaultScope pro položku s názvem CITest01.

Příklad 3: Změna nastavení položky

PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction RemoveMembership -SecurityScopeName "DefaultScope"

Tento příkaz nastaví akci oboru zabezpečení na RemoveMembership a název oboru zabezpečení na DefaultScope pro položku s názvem CITest01.

PARAMETERS

-AddCategory

Určuje pole lokalizovaných názvů kategorií, do kterých položka konfigurace patří.

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

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

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

-Description (Popis)

Určuje popis položky konfigurace.

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

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

-Digest

Určuje hodnotu hash, která obsahuje položku konfigurace.

Type: ConfigurationItem
Parameter Sets: (All)
Aliases:

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

-DigestPath

Určuje cestu k hodnotě hash.

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

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

-DigestXml

Určuje definici XML.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Určuje pole identifikátorů pro jednu nebo více položek konfigurace. Můžete použít seznam oddělený čárkami.

Type: Int32
Parameter Sets: SetByIdMandatory
Aliases: CIId, CI_ID

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

-InputObject

Určuje objekt položky konfigurace. K získání objektu položky konfigurace můžete použít rutinu Get-CMConfigurationItem.

Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:

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

-Name

Určuje pole názvů pro položky konfigurace.

Type: String
Parameter Sets: SetByNameMandatory
Aliases: LocalizedDisplayName

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

-NewName

Určuje nový název položky konfigurace.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Vrátí aktuální pracovní objekt. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-RemoveCategory

Určuje pole lokalizovaných názvů kategorií, ze kterých se má položka konfigurace odebrat.

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

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

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

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

POZNÁMKY

Úvod do dodržování Nastavení v Správce konfigurace

Get-CMConfigurationItem

Get-CMConfigurationItemXMLDefinition

Get-CMConfigurationItemHistory

New-CMConfigurationItem

Remove-CMConfigurationItem

Import-CMConfigurationItem

Export-CMConfigurationItem

ConvertTo-CMConfigurationItem

ConvertFrom-CMConfigurationItem