Set-CMDriverPackage

Módulo:

ConfigurationManager

Modificar um pacote de driver.

Syntax

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

Use este cmdlet para modificar um pacote de driver.

Para obter mais informações, consulte Gerenciar drivers no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Configurar o fabricante e o modelo de um pacote de driver

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

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

Parâmetros

-Confirm

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

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

-CopyToPackageShareOnDistributionPoint

Os clientes sempre podem baixar um pacote de driver de um ponto de distribuição. Se você definir esse parâmetro como $true, o site o disponibiliza por meio de um compartilhamento de rede nomeado em pontos de distribuição. Use CustomPackageShareName para especificar um nome de compartilhamento personalizado.

Quando você habilita essa opção, mais espaço é necessário nos pontos de distribuição. Ela se aplica a todos os pontos de distribuição aos quais você distribui esse pacote de driver.

Type:	Boolean
Aliases:	CopyToPackageShareOnDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomPackageShareName

Se você habilitar CopyToPackageShareOnDistributionPoint, poderá usar esse parâmetro para personalizar o nome do compartilhamento. O comprimento máximo é de 127 caracteres e não pode incluir nenhum dos seguintes caracteres: " / [ ] : | < > + = ; , ? * . Você pode especificar um nome de compartilhamento e um nome de pasta, mas, em seguida, o máximo para cada um é 80 caracteres. Por exemplo, ShareName\FolderName.

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

-Description

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

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-DisconnectUserFromDistributionPoint

Essa opção foi preterida. Ele define a propriedade ForcedDisconnectEnabled do pacote de driver.

Type:	Boolean
Aliases:	DisconnectUsersFromDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointMins

Essa opção foi preterida. Ele define a propriedade ForcedDisconnectDelay do pacote de driver.

Type:	UInt32
Aliases:	DisconnectUsersFromDistributionPointsMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointRetryCount

Essa opção foi preterida. Ele define a propriedade ForcedDisconnectNumRetries do pacote de driver.

Type:	UInt32
Aliases:	DisconnectUsersFromDistributionPointsRetries
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DistributionPointUpdateSchedule

Use esse parâmetro para atualizar pontos de distribuição em um cronograma. Para obter um objeto schedule, use o cmdlet New-CMSchedule.

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

-DriverManufacturer

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

Use-o com o parâmetro DriverModel. Você pode usá-los para gerenciar o catálogo de driver e com o pré-cache da sequência de tarefas. Para obter mais informações, consulte Configure pre-cache content for task sequences.

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

-DriverModel

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

Use-o com o parâmetro DriverManufacturer. Você pode usá-los para gerenciar o catálogo de driver e com o pré-cache da sequência de tarefas. Para obter mais informações, consulte Configure pre-cache content for task sequences.

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

-DriverPackageSource

Especifique um caminho de arquivo para o local da rede para origem dos arquivos de driver.

Quando você cria um pacote de driver, o local de origem do pacote deve apontar para um compartilhamento de rede vazio que não é usado por outro pacote de driver. O Provedor de SMS deve ter permissões de controle total para esse local.

Quando você adiciona drivers de dispositivo a um pacote de driver, o Configuration Manager copia-o para esse caminho. Você pode adicionar a um pacote de driver somente drivers de dispositivo importados e habilitados no catálogo de drivers.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

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

-Id

Especifique a ID de um pacote de driver a ser configurada. Esse valor é uma ID de pacote padrão, por exemplo: XYZ00020 .

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

-InputObject

Especifique um objeto de pacote de driver para configurar. Para obter esse objeto, use o cmdlet Get-CMDriverPackage.

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

-MulticastAllow

De definir esse parâmetro como $true permitir que esse pacote seja transferido por meio de multicast. Para obter mais informações, consulte Use multicast para implantarWindows pela rede com o Configuration Manager .

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

-MulticastEncrypt

Se você habilitar MulticastAllow, de definir esse parâmetro como $true criptografar pacotes de multicast.

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

-MulticastTransferOnly

Se você habilitar MulticastAllow, de definir esse parâmetro como $true transferir esse pacote de driver somente por meio de multicast.

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

-Name

Especifique o nome de um pacote de driver a ser configurada.

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

-NewName

Especifique um novo nome para o pacote de driver.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-PrestageBehavior

Especifique o comportamento ao habilitar um ponto de distribuição para conteúdo prestaged:

• ManualCopy: Copie manualmente o conteúdo deste pacote para o ponto de distribuição
• DownloadDelta: Baixar somente alterações de conteúdo para o ponto de distribuição
• OnDemand: Baixe automaticamente o conteúdo quando os pacotes são atribuídos aos pontos de distribuição

Para obter mais informações, consulte Use prestaged content.

Type:	PrestageBehavior
Accepted values:	ManualCopy, DownloadDelta, OnDemand
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Priority

Especifique a ordem na 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. Pacotes com prioridade igual são enviados na ordem em que são criados.

Type:	Priority
Accepted values:	High, Medium, Low
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SendToPreferredDistributionPoint

Se você quiser habilitar a distribuição de conteúdo sob demanda para pontos de distribuição preferenciais, de definir esse parâmetro como $true. Quando você habilita essa configuração, se um cliente solicitar o conteúdo do pacote e o conteúdo não estiver disponível em nenhum ponto de distribuição, o ponto de gerenciamento distribuirá o conteúdo. Para obter mais informações, consulte Distribuição de conteúdo sob demanda.

Type:	Boolean
Aliases:	SendToPreferredDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Version

Especifique a versão do pacote de driver. Esse valor é uma cadeia de caracteres que você gerencia.

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

-WhatIf

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

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Links Relacionados

• Export-CMDriverPackage
• Get-CMDriverPackage
• Import-CMDriverPackage
• New-CMDriverPackage
• Remove-CMDriverPackage
• Gerenciar drivers no Configuration Manager