Set-CMConfigurationItem
SYNOPSIS
Wijzigt de instellingen voor een Configuration Manager configuratie-item.
SYNTAX
SetByIdMandatory (standaard)
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
De cmdlet Set-CMConfigurationItem wijzigt de instellingen voor een Configuration Manager configuratie-item.
Configuratie-items bevatten een of meer instellingen, samen met nalevingsregels. Items definiëren meestal een configuratie-eenheid die u wilt bewaken. Zie Introduction to Compliance Instellingen in Configuration Manager voor meer informatie over configuratie-items.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\>
. Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: De naam van een configuratie-item wijzigen
PS XYZ:\> Set-CMConfigurationItem -Name "CITest" -NewName "CITest01"
Met deze opdracht wordt de naam van het configuratie-item met de naam CITest gewijzigd in CITest01.
Voorbeeld 2: Iteminstellingen instellen
PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction AddMembership -SecurityScopeName "DefaultScope"
Met deze opdracht stelt u de actie voor het beveiligingsbereik in op AddMembership en de naam van het beveiligingsbereik op DefaultScope voor het item met de naam CITest01.
Voorbeeld 3: Iteminstellingen wijzigen
PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction RemoveMembership -SecurityScopeName "DefaultScope"
Met deze opdracht stelt u de actie voor het beveiligingsbereik in op RemoveMembership en de naam van het beveiligingsbereik op DefaultScope voor het item met de naam CITest01.
PARAMETERS
-AddCategory
Hiermee geeft u een matrix met gelokaliseerde namen van de categorieën waar het configuratie-item bij hoort.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-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
-Beschrijving
Hiermee geeft u een beschrijving voor een configuratie-item.
Type: String
Parameter Sets: (All)
Aliases: LocalizedDescription
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Digest
Hiermee geeft u de Samenvatting op die het configuratie-item bevat.
Type: ConfigurationItem
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DigestPath
Hiermee geeft u het pad van de Samenvatting.
Type: String
Parameter Sets: (All)
Aliases: DesiredConfigurationDigestPath
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DigestXml
Hiermee geeft u de XML-definitie.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
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
-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 een matrix met id's op voor een of meer configuratie-items. U kunt een door komma's gescheiden lijst gebruiken.
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
Hiermee geeft u een configuratie-itemobject. Als u een configuratie-itemobject wilt verkrijgen, kunt u de cmdlet Get-CMConfigurationItem gebruiken.
Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Hiermee geeft u een matrix met namen voor configuratie-items.
Type: String
Parameter Sets: SetByNameMandatory
Aliases: LocalizedDisplayName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Hiermee geeft u een nieuwe naam op voor een configuratie-item.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Retourneert het huidige werkende object. Deze cmdlet genereert standaard geen uitvoer.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveCategory
Hiermee geeft u een matrix met gelokaliseerde namen van de categorieën op waaruit het configuratie-item moet worden verwijderd.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
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
RELATED LINKS
Inleiding tot naleving Instellingen in Configuration Manager
Get-CMConfigurationItemXMLDefinition