Freigeben über

New-CMConfigurationItem

  • Referenz
Modul:
ConfigurationManager

Erstellt ein Configuration Manager-Konfigurationselement.

Syntax

New-CMConfigurationItem
   [-Category <String[]>]
   [-Description <String>]
   -Name <String>
   -ParentConfigurationItem <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMConfigurationItem
   [-Category <String[]>]
   -CreationType <CICreationType>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-CMConfigurationItem erstellt ein Konfigurationselement in Configuration Manager. Erstellen Sie Konfigurationselemente, um Konfigurationen zu definieren, die Sie auf Geräten verwalten und bewerten möchten.

Sie können den Parameter ParentConfigurationItem angeben, um ein untergeordnetes Konfigurationselement zu erstellen. Untergeordnete Konfigurationselemente in Configuration Manager sind Kopien von Konfigurationselementen, die eine Beziehung zum ursprünglichen Konfigurationselement beibehalten. daher erben sie die ursprüngliche Konfiguration vom übergeordneten Konfigurationselement. Sie können keine untergeordneten Konfigurationselemente für mobile Geräte erstellen.

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: Erstellen eines Konfigurationselements

PS XYZ:\> New-CMConfigurationItem -CreationType MobileDevice -Name "MD_Config88"

Dieser Befehl erstellt ein Konfigurationselement für mobile Geräte mit dem Namen MD_Config88.

Parameter

-Category

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

Typ:String[]
Aliase:LocalizedCategoryInstanceNames
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CreationType

Gibt den Typ des Konfigurationselements an. Folgende Werte sind für diesen Parameter zulässig:

  • MacOS
  • MobileDevice
  • Keine
  • WindowsApplication
  • WindowsOS
Typ:CICreationType
Zulässige Werte:None, WindowsApplication, WindowsOS, MacOS, MobileDevice
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für ein Konfigurationselement an.

Typ:String
Aliase:LocalizedDescription
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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

-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

-Name

Gibt einen Namen für das Konfigurationselement an.

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

-ParentConfigurationItem

Gibt ein übergeordnetes CMConfigurationItem-Objekt an. Verwenden Sie zum Abrufen eines CMConfigurationItem-Objekts das Cmdlet Get-CMConfigurationItem .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject