New-CMPackage

  • 参考
模块:
ConfigurationManager

创建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 之前进行确认。

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

-Description

指定包的说明。 最多可以使用 128 个字符。

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

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

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

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。

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

-FromDefinition

指示Configuration Manager从包定义文件创建包。

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

-Language

指定包的语言版本。 您最多可以使用 32 个字符，该格式选择用于标识语言版本。 Configuration Manager将 Language 参数与 Manufacturer、Name 和 Version 一起使用来标识包。 例如，可以具有同一包的英语版本和德语版本。

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

-Manufacturer

指定制造商名称以帮助你标识包。 最多可以使用 32 个字符。

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

-Name

指定包的名称。

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

-PackageDefinitionName

指定包定义文件的名称。

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

-PackageNoSourceFile

指示包不需要在客户端设备上存在源文件。

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

-PackagePath

指定Configuration Manager为分发点上的包源文件创建的共享名称或路径。

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

-Path

指定要添加到包的文件的位置。

可以指定完整的本地路径或 UNC 路径。 确保此位置包含程序需要完成的所有文件和子目录，包括任何脚本。

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

-SourceFileType

指定源文件类型。 此参数可接受的值为：

  • AlwaysObtainSourceFile
  • CreateCompressedVersionOfSourceFile
Type:SourceFileType
Accepted values:AlwaysObtainSourceFile, CreateCompressedVersionOfSourceFile
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SourceFolderPath

指定包的源文件的位置。

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

-SourceFolderPathType

指定源文件夹路径类型。 此参数可接受的值为：

  • LocalFolderOnSiteServer
  • UncNetworkPath
Type:SourceFolderPathType
Accepted values:UncNetworkPath, LocalFolderOnSiteServer
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Version

指定包的版本号。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

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

输入

None

输出

IResultObject