Set-CMDriverPackage

Módulo:

ConfigurationManager

Modificar um pacote de controlador.

Sintaxe

Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   -InputObject <IResultObject>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   -Id <String>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilize este cmdlet para modificar um pacote de controlador.

Para obter mais informações, veja Gerir controladores no 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: Configurar o fabricante e o modelo de um pacote de controlador

Este comando configura o fabricante e o modelo do pacote de controlador com o ID XYZ00091.

Set-CMDriverPackage -PackageId "XYZ00091" -DriverManufacturer "Microsoft" -DriverModel "Surface 2"

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

-CopyToPackageShareOnDistributionPoint

Os clientes podem sempre transferir um pacote de controladores a partir de um ponto de distribuição. Se definir este parâmetro como $true, o site disponibiliza-o através de uma partilha de rede nomeada em pontos de distribuição. Utilize CustomPackageShareName para especificar um nome de partilha personalizado.

Quando ativa esta opção, é necessário mais espaço nos pontos de distribuição. Aplica-se a todos os pontos de distribuição aos quais distribui este pacote de controladores.

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

-CustomPackageShareName

Se ativar CopyToPackageShareOnDistributionPoint, pode utilizar este parâmetro para personalizar o nome da partilha. O comprimento máximo é de 127 carateres e não pode incluir nenhum dos seguintes carateres: " / [ ] : | < > + = ; , ? *. Pode especificar um nome de partilha e um nome de pasta, mas o máximo para cada um é de 80 carateres. Por exemplo, ShareName\FolderName.

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

-Description

Especifique uma descrição opcional de um pacote de controlador para o ajudar a identificá-lo.

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

-DisconnectUserFromDistributionPoint

Esta opção foi preterida. Define a propriedade ForcedDisconnectEnabled do pacote de controlador.

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

-DisconnectUserFromDistributionPointMins

Esta opção foi preterida. Define a propriedade ForcedDisconnectDelay do pacote de controlador.

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

-DisconnectUserFromDistributionPointRetryCount

Esta opção foi preterida. Define a propriedade ForcedDisconnectNumRetries do pacote de controlador.

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

-DistributionPointUpdateSchedule

Utilize este parâmetro para atualizar pontos de distribuição com base numa agenda. Para obter um objeto de agendamento, utilize o cmdlet New-CMSchedule .

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

-DriverManufacturer

Utilize este parâmetro para definir o fabricante do dispositivo. O comprimento máximo é de 100 caracteres.

Utilize-o com o parâmetro DriverModel . Pode utilizá-los para gerir o catálogo de controladores e com a pré-colocação em cache da sequência de tarefas. Para obter mais informações, veja Configurar conteúdo de pré-cache para sequências de tarefas.

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

-DriverModel

Utilize este parâmetro para definir o modelo do dispositivo. O comprimento máximo é de 100 caracteres.

Utilize-o com o parâmetro DriverManufacturer . Pode utilizá-los para gerir o catálogo de controladores e com a pré-colocação em cache da sequência de tarefas. Para obter mais informações, veja Configurar conteúdo de pré-cache para sequências de tarefas.

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

-DriverPackageSource

Especifique um caminho de ficheiro para a localização de rede para obter os ficheiros do controlador.

Quando cria um pacote de controladores, a localização de origem do pacote tem de apontar para uma partilha de rede vazia que não seja utilizada por outro pacote de controlador. O Fornecedor de SMS tem de ter permissões de Controlo total para essa localização.

Quando adiciona controladores de dispositivo a um pacote de controlador, o Configuration Manager copia-o para este caminho. Pode adicionar a um pacote de controladores apenas controladores de dispositivo que tenha importado e que estejam ativados no catálogo de controladores.

Tipo:	String
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

-Id

Especifique o ID de um pacote de controlador a configurar. Este valor é um ID de pacote padrão, por exemplo: XYZ00020.

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

-InputObject

Especifique um objeto de pacote de controlador a configurar. Para obter este objeto, utilize o cmdlet Get-CMDriverPackage .

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

-MulticastAllow

Defina este parâmetro como $true para permitir que este pacote seja transferido através de multicast. Para obter mais informações, veja Utilizar multicast para implementar o Windows através da rede com o Configuration Manager.

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

-MulticastEncrypt

Se ativar MulticastAllow, defina este parâmetro como $true para encriptar pacotes multicast.

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

-MulticastTransferOnly

Se ativar MulticastAllow, defina este parâmetro como $true para transferir apenas este pacote de controlador através de multicast.

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

-Name

Especifique o nome de um pacote de controlador a configurar.

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

-NewName

Especifique um novo nome para o pacote de controlador.

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

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

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

-PrestageBehavior

Especifique o comportamento quando ativa um ponto de distribuição para conteúdo pré-configurado:

• ManualCopy: copie manualmente o conteúdo deste pacote para o ponto de distribuição
• DownloadDelta: transferir apenas alterações de conteúdo para o ponto de distribuição
• OnDemand: transferir automaticamente conteúdo quando os pacotes são atribuídos a pontos de distribuição

Para obter mais informações, veja Utilizar conteúdo pré-configurado.

Tipo:	PrestageBehavior
Valores aceitos:	ManualCopy, DownloadDelta, OnDemand
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Priority

Especifique a ordem pela qual o site envia o conteúdo para outros sites e os pontos de distribuição neste site.

O site envia conteúdo de alta prioridade antes de pacotes com prioridade média ou baixa. Os pacotes com prioridade igual são enviados pela ordem em que são criados.

Tipo:	Priority
Valores aceitos:	High, Medium, Low
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SendToPreferredDistributionPoint

Se quiser ativar a distribuição de conteúdos a pedido para pontos de distribuição preferenciais, defina este parâmetro como $true. Quando ativa esta definição, se um cliente pedir o conteúdo do pacote e o conteúdo não estiver disponível em pontos de distribuição, o ponto de gestão distribui o conteúdo. Para obter mais informações, veja Distribuição de conteúdos a pedido.

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

-Version

Especifique a versão do pacote de controlador. Este valor é uma cadeia que gere.

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Links Relacionados

• Export-CMDriverPackage
• Get-CMDriverPackage
• Import-CMDriverPackage
• New-CMDriverPackage
• Remove-CMDriverPackage
• Gerir controladores no Configuration Manager