Set-CMConfigurationItem
SYNOPSIS
Ändrar inställningarna för ett Konfigurationshanteraren konfigurationsobjekt.
SYNTAX
SetByIdMandatory (standard)
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
Cmdleten Set-CMConfigurationItem ändrar inställningarna för ett Konfigurationshanteraren konfigurationsobjekt.
Konfigurationsobjekt innehåller en eller flera inställningar, tillsammans med efterlevnadsregler. Objekt definierar vanligtvis en konfigurationsenhet som du vill övervaka. Mer information om konfigurationsobjekt finns i Introduktion till efterlevnad Inställningar i Konfigurationshanteraren.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Ändra namnet på ett konfigurationsobjekt
PS XYZ:\> Set-CMConfigurationItem -Name "CITest" -NewName "CITest01"
Det här kommandot ändrar namnet på konfigurationsobjektet med namnet CITest till CITest01.
Exempel 2: Ange objektinställningar
PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction AddMembership -SecurityScopeName "DefaultScope"
Det här kommandot anger åtgärden för säkerhetsomfattning till AddMembership och namnet på säkerhetsomfattningen till DefaultScope för objektet CITest01.
Exempel 3: Ändra objektinställningar
PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction RemoveMembership -SecurityScopeName "DefaultScope"
Det här kommandot anger åtgärden för säkerhetsomfattning till RemoveMembership och namnet på säkerhetsomfattningen till DefaultScope för objektet CITest01.
PARAMETERS
-AddCategory
Anger en matris med lokaliserade namn på de kategorier som konfigurationsobjektet tillhör.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-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 för ett konfigurationsobjekt.
Type: String
Parameter Sets: (All)
Aliases: LocalizedDescription
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Sammanfatta
Anger sammanfattningen som innehåller konfigurationsobjektet.
Type: ConfigurationItem
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DigestPath
Anger sökvägen till Sammanfattning.
Type: String
Parameter Sets: (All)
Aliases: DesiredConfigurationDigestPath
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DigestXml
Anger XML-definitionen.
Type: String
Parameter Sets: (All)
Aliases:
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 en matris med identifierare för ett eller flera konfigurationsobjekt. Du kan använda en kommaavgränsad lista.
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
Anger ett konfigurationsobjektsobjekt. Om du vill hämta ett konfigurationsobjektobjekt kan du använda cmdleten 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
Anger en matris med namn för konfigurationsobjekt.
Type: String
Parameter Sets: SetByNameMandatory
Aliases: LocalizedDisplayName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Anger ett nytt namn för ett konfigurationsobjekt.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Returnerar det aktuella arbetsobjektet. Som standard genererar denna cmdlet inga utdata.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveCategory
Anger en matris med lokaliserade namn på de kategorier som konfigurationsobjektet ska tas bort från.
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
RELATED LINKS
Introduktion till efterlevnad Inställningar i Konfigurationshanteraren
Get-CMConfigurationItemXMLDefinition