New-CMConfigurationItem

參考

模組:: ConfigurationManager

建立 Configuration Manager 設定項目。

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>]

Description

CMConfigurationItem Cmdlet 會在 configuration Manager 中建立設定項目。建立設定專案以定義您想要在裝置上管理及評估規範的設定。

您可以指定 ParentConfigurationItem 參數來建立子設定項目。設定管理器中的子設定專案是保留與原始設定專案關聯的設定項目副本;因此，它們會從父系設定專案繼承原始設定。您無法為行動裝置建立子設定項目。

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。如需詳細資訊，請參閱快速入門。

範例

範例1：建立設定項目

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

這個命令會為名為 MD_Config88 的行動裝置建立一個設定專案。

參數

-Confirm

執行 Cmdlet 之前提示您確認。

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

-CreationType

會指定設定項目的類型。此參數可接受的值為：

MacOS
Clear-mobiledevice 程式
無
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

指定設定專案的描述。

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

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。您無法將它與 ForceWildcardHandling合併。

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

-ForceWildcardHandling

這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。您無法將它與 DisableWildcardHandling合併。

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

-ParentConfigurationItem

指定父 CMConfigurationItem 物件。若要取得 CMConfigurationItem 物件，請使用 CMConfigurationItem Cmdlet。

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

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。未執行 Cmdlet。

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

-名稱

指定設定專案的名稱。

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

-類別

會指定 configuration 專案所屬類別的當地語系化名稱陣列。

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

輸入

ConfigurationManagement IResultObject

輸出

IResultObject