Get-CMConfigurationItem

Referenz

Modul:: ConfigurationManager

Ruft Configuration Manager-Konfigurationselemente ab.

Syntax

Get-CMConfigurationItem
   [-Fast]
   [[-Name] <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMConfigurationItem
   [-Fast]
   [-Id] <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Das Cmdlet "Get-CMConfigurationItem" ruft Konfigurationselementobjekte in Configuration Manager ab. Sie können dieses Cmdlet verwenden, um Elemente abzurufen, die von anderen Cmdlets verwendet werden sollen. Beispielsweise können Sie Konfigurationselemente abrufen, damit Sie die Set-CMConfigurationItem verwenden können, um die Einstellungen für sie zu ändern.

Konfigurationselemente enthalten eine oder mehrere Einstellungen sowie Kompatibilitätsregeln. Weitere Informationen zu Konfigurationselementen finden Sie unter Einführung in Compliance-Einstellungen in Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Abrufen eines Elements mithilfe eines Namens

PS XYZ:\> Get-CMConfigurationItem -Name "ConfigItem76"

Dieser Befehl ruft ein Konfigurationselement mit dem Namen ConfigItem76 ab.

Beispiel 2: Abrufen eines Elements zur Verwendung mit einem anderen Cmdlet

PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Remove-CMConfigurationItem -InputObject $CIObj

Der erste Befehl ruft ein Konfigurationselement mit dem angegebenen Bezeichner ab und speichert es in der variablen $CIObj.

Mit dem zweiten Befehl wird das Element in der variablen $CIObj entfernt.

Parameter

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-Fast

Gibt an, dass das Cmdlet nicht automatisch verzögerte Eigenschaften aktualisiert.

Lazy-Eigenschaften enthalten Werte, die relativ ineffizient sind, um abgerufen zu werden, was zu zusätzlichem Netzwerkdatenverkehr führen und die Leistung von Cmdlets verringern kann. Wenn keine verzögerten Eigenschaften erforderlich sind, sollte dieser Parameter angegeben werden.

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

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
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 Kommas getrennte Liste verwenden.

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

-Name

Gibt ein Array von Namen von Konfigurationselementen an. Sie können eine durch Kommas getrennte Liste verwenden.

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

Eingaben

Keine

Ausgaben

IResultObject[]

IResultObject