New-CMPackage
创建 Configuration Manager 包。
语法
New-CMPackage
   [-Description <String>]
   [-Language <String>]
   [-Manufacturer <String>]
   -Name <String>
   [-Path <String>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]New-CMPackage
   [-FromDefinition]
   -PackageDefinitionName <String>
   [-PackageNoSourceFile]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]New-CMPackage
   [-FromDefinition]
   [-PackageNoSourceFile]
   -PackagePath <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]New-CMPackage
   [-FromDefinition]
   -PackageDefinitionName <String>
   -SourceFileType <SourceFileType>
   -SourceFolderPath <String>
   -SourceFolderPathType <SourceFolderPathType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]New-CMPackage
   [-FromDefinition]
   -PackagePath <String>
   -SourceFileType <SourceFileType>
   -SourceFolderPath <String>
   -SourceFolderPathType <SourceFolderPathType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]说明
New-CMPackage cmdlet 创建 Configuration Manager 包。 包是一个 Configuration Manager 对象,其中包含用于将程序、软件更新、启动映像、操作系统映像和驱动程序分发到 Configuration Manager 客户端的内容文件和说明。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门。
示例
示例 1:创建包
PS XYZ:\> New-CMPackage -Name "ScriptsPackage01"此命令创建名为 ScriptsPackage01 的 Configuration Manager 包。
示例 2:创建包并添加说明
PS XYZ:\> New-CMPackage -Name "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."此命令创建名为 ScriptsPackage02 的 Configuration Manager 包,并将指定的说明添加到包。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter | 
| 别名: | cf | 
| Position: | Named | 
| 默认值: | False | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Description
指定包的说明。 最多可以使用 128 个字符。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-ForceWildcardHandling
此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-FromDefinition
指示 Configuration Manager 从包定义文件创建包。
| 类型: | SwitchParameter | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Language
指定包的语言版本。 最多可以使用 32 个字符,该格式选择用于标识语言版本。 Configuration Manager 将 Language 参数与 Manufacturer、 Name 和 Version 一起使用来标识包。 例如,可以具有同一包的英语版本和德语版本。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Manufacturer
指定制造商名称以帮助你标识包。 最多可以使用 32 个字符。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Name
指定包的名称。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-PackageDefinitionName
指定包定义文件的名称。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-PackageNoSourceFile
指示包不需要在客户端设备上存在源文件。
| 类型: | SwitchParameter | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-PackagePath
指定 Configuration Manager 为分发点上的包源文件创建的共享名称或路径。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Path
指定要添加到包的文件的位置。
可以指定完整的本地路径或 UNC 路径。 确保此位置包含程序需要完成的所有文件和子目录,包括任何脚本。
| 类型: | String | 
| 别名: | PackageSourcePath | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-SourceFileType
指定源文件类型。 此参数可接受的值为:
- AlwaysObtainSourceFile
- CreateCompressedVersionOfSourceFile
| 类型: | SourceFileType | 
| 接受的值: | AlwaysObtainSourceFile, CreateCompressedVersionOfSourceFile | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-SourceFolderPath
指定包的源文件的位置。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-SourceFolderPathType
指定源文件夹路径类型。 此参数可接受的值为:
- LocalFolderOnSiteServer
- UncNetworkPath
| 类型: | SourceFolderPathType | 
| 接受的值: | UncNetworkPath, LocalFolderOnSiteServer | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Version
指定包的版本号。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter | 
| 别名: | wi | 
| Position: | Named | 
| 默认值: | False | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
输入
None
输出
IResultObject