New-CMPackage

Cria um pacote do Configuration Manager.

Sintaxe

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

Description

O cmdlet New-CMPackage cria um pacote do Configuration Manager. Um pacote é um objeto do Configuration Manager que contém os ficheiros de conteúdo e instruções para distribuir programas, atualizações de software, imagens de arranque, imagens do sistema operativo e controladores para clientes do Configuration Manager.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Criar um pacote

PS XYZ:\> New-CMPackage -Name "ScriptsPackage01"

Este comando cria um pacote do Configuration Manager com o nome ScriptsPackage01.

Exemplo 2: Criar um pacote e adicionar uma descrição

PS XYZ:\> New-CMPackage -Name "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."

Este comando cria um pacote do Configuration Manager com o nome ScriptsPackage02 e adiciona a descrição especificada ao pacote.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifica uma descrição para o pacote. Pode utilizar um máximo de 128 carateres.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FromDefinition

Indica que o Configuration Manager cria o pacote a partir de um ficheiro de definição de pacote.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Language

Especifica a versão de idioma do pacote. Pode utilizar um máximo de 32 carateres num formato que opte por utilizar para identificar a versão do idioma. O Configuration Manager utiliza o parâmetro Idioma juntamente com o Fabricante, o Nome e a Versão para identificar um pacote. Por exemplo, pode ter uma versão em inglês e uma versão alemã do mesmo pacote.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Manufacturer

Especifica um nome de fabricante para o ajudar a identificar o pacote. Pode utilizar um máximo de 32 carateres.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica um nome para o pacote.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PackageDefinitionName

Especifica o nome de um ficheiro de definição de pacote.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PackageNoSourceFile

Indica que o pacote não requer que os ficheiros de origem estejam presentes nos dispositivos cliente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PackagePath

Especifica um nome de partilha ou caminho que o Configuration Manager cria para os ficheiros de origem do pacote em pontos de distribuição.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Path

Especifica a localização dos ficheiros a adicionar ao pacote.

Pode especificar um caminho local completo ou um caminho UNC. Certifique-se de que esta localização contém todos os ficheiros e subdiretórios que o programa precisa de concluir, incluindo quaisquer scripts.

Tipo:String
Aliases:PackageSourcePath
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SourceFileType

Especifica o tipo de ficheiro de origem. Os valores aceitáveis para esse parâmetro são:

  • AlwaysObtainSourceFile
  • CreateCompressedVersionOfSourceFile
Tipo:SourceFileType
Valores aceitos:AlwaysObtainSourceFile, CreateCompressedVersionOfSourceFile
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SourceFolderPath

Especifica a localização dos ficheiros de origem do pacote.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SourceFolderPathType

Especifica o tipo de caminho da pasta de origem. Os valores aceitáveis para esse parâmetro são:

  • LocalFolderOnSiteServer
  • UncNetworkPath
Tipo:SourceFolderPathType
Valores aceitos:UncNetworkPath, LocalFolderOnSiteServer
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Version

Especifica um número de versão para o pacote.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject