Freigeben über

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 können. Beispielsweise können Sie Konfigurationselemente abrufen, sodass Sie die Set-CMConfigurationItem verwenden können, um einstellungen für diese zu ändern.

Konfigurationselemente enthalten mindestens eine Einstellung sowie Kompatibilitätsregeln. 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-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen eines Elements mit einem Namen

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.

Der zweite Befehl entfernt das Element in der variablen $CIObj.

Parameter

-DisableWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Fast

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

Verzögerte Eigenschaften enthalten Werte, die relativ ineffizient abgerufen werden können, was zusätzlichen Netzwerkdatenverkehr verursachen und die Cmdlet-Leistung beeinträchtigen kann. Wenn verzögerte Eigenschaften nicht benötigt werden, sollte dieser Parameter angegeben werden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

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

Typ:Int32
Aliase:CIId, CI_ID
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

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

Typ:String
Aliase:LocalizedDisplayName
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

Eingaben

None

Ausgaben

IResultObject[]

IResultObject