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