Set-CMConfigurationItem

  • Referenz
Modul:
ConfigurationManager

Ändert die Einstellungen für ein Configuration Manager Konfigurationselement.

Syntax

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

Beschreibung

Das Cmdlet Set-CMConfigurationItem ändert die Einstellungen für ein Configuration Manager Konfigurationselement.

Konfigurationselemente enthalten mindestens eine Einstellung sowie Kompatibilitätsregeln. Elemente definieren in der Regel eine Konfigurationseinheit, die Sie überwachen möchten. Weitere Informationen zu Konfigurationselementen finden Sie unter Einführung in Kompatibilitätseinstellungen in Configuration Manager.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Ändern des Namens eines Konfigurationselements

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

Dieser Befehl ändert den Namen des Konfigurationselements namens CITest in CITest01.

Beispiel 2: Festlegen von Elementeinstellungen

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

Dieser Befehl legt die Sicherheitsbereichsaktion auf AddMembership und den Namen des Sicherheitsbereichs auf DefaultScope für das Element mit dem Namen CITest01 fest.

Beispiel 3: Ändern der Elementeinstellungen

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

Dieser Befehl legt die Sicherheitsbereichsaktion auf RemoveMembership und den Namen des Sicherheitsbereichs auf DefaultScope für das Element mit dem Namen CITest01 fest.

Parameter

-AddCategory

Gibt ein Array lokalisierter Namen der Kategorien an, zu denen das Konfigurationselement gehört.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Gibt eine Beschreibung für ein Konfigurationselement an.

Type:String
Aliases:LocalizedDescription
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Digest

Gibt den Digest an, der das Konfigurationselement enthält.

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

-DigestPath

Gibt den Pfad des Digests an.

Type:String
Aliases:DesiredConfigurationDigestPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DigestXml

Gibt die XML-Definition an.

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

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-Id

Gibt ein Array von Bezeichnern für ein oder mehrere Konfigurationselemente an. Sie können eine durch Trennzeichen getrennte Liste verwenden.

Type:Int32
Aliases:CIId, CI_ID
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Gibt ein Konfigurationselementobjekt an. Zum Abrufen eines Konfigurationselementobjekts können Sie das Cmdlet Get-CMConfigurationItem verwenden.

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

-Name

Gibt ein Array von Namen für Konfigurationselemente an.

Type:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Gibt einen neuen Namen für ein Konfigurationselement an.

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

-PassThru

Gibt das aktuelle Arbeitsobjekt zurück. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

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

-RemoveCategory

Gibt ein Array lokalisierter Namen der Kategorien an, aus denen das Konfigurationselement entfernt werden soll.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object