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 verwalten und für die Kompatibilität auf Geräten 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 beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Erstellen eines Konfigurationselements

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

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

Parameter

-Category

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

Type:String[]
Aliases:LocalizedCategoryInstanceNames
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-CreationType

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

  • Macos
  • MobileDevice
  • Keine
  • WindowsApplication
  • WindowsOS
Type:CICreationType
Accepted values:None, WindowsApplication, WindowsOS, MacOS, MobileDevice
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-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

-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

-Name

Gibt einen Namen für das Konfigurationselement an.

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

-ParentConfigurationItem

Gibt ein übergeordnetes CMConfigurationItem-Objekt an. Verwenden Sie das Cmdlet "Get-CMConfigurationItem", um ein CMConfigurationItem-Objekt abzurufen.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
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
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject