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 参数与 ManufacturerNameVersion 一起使用来标识包。 例如,可以具有同一包的英语版本和德语版本。

类型: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