Share via


Set-CMDriverPackage

SYNOPSIS

Modifique um pacote de motorista.

SYNTAX

SetByValueMandatory (Padrão)

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

SetById

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

SetByName

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 uma embalagem do controlador.

Para obter mais informações, consulte Gerir os controladores no Gestor de Configuração.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

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

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

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

PARAMETERS

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-CopyToPackageShareOnDistributionPoint

Os clientes podem sempre descarregar um pacote de motorista a partir de um ponto de distribuição. Se definir este parâmetro para $true, o site disponibiliza-o através de uma partilha de rede nomeada em pontos de distribuição. Utilize o Nome CustomPackageShare 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 a que distribui este pacote de condutor.

Type: Boolean
Parameter Sets: (All)
Aliases: CopyToPackageShareOnDistributionPoints

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

-CustomPackageShareName

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Descrição

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

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DisconnectUserFromDistributionPoint

Esta opção é depreciada. Define a propriedade ForcedDisconnectEnabled do pacote do condutor.

Type: Boolean
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPoints

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

-DisconnectUserFromDistributionPointMins

Esta opção é depreciada. Define a propriedade ForcedDisconnectDelay do pacote do motorista.

Type: UInt32
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPointsMinutes

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

-DisconnectUserFromDistributionPointRetryCount

Esta opção é depreciada. Define a propriedade ForcedDisconnectNumRetries do pacote do condutor.

Type: UInt32
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPointsRetries

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

-DistributionPointUpdateSchedule

Utilize este parâmetro para atualizar pontos de distribuição num horário. Para obter um objeto de agenda, use o cmdlet New-CMSchedule.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-DriverManufacturer

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

Use-o com o parâmetro DriverModel. Pode usá-los para gerir o catálogo do condutor e com a sequência de tarefas pré-caching. Para obter mais informações, consulte o conteúdo pré-cache de configuração para sequências de tarefas.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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 usá-los para gerir o catálogo do condutor e com a sequência de tarefas pré-caching. Para obter mais informações, consulte o conteúdo pré-cache de configuração para sequências de tarefas.

Type: String
Parameter Sets: (All)
Aliases:

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

-DriverPackageSource

Especifique uma trajetória de ficheiro para a localização da rede para obter os ficheiros do controlador.

Quando criar um pacote de motorista, a localização de origem da embalagem deve indicar uma partilha de rede vazia que não seja usada por outro pacote de motorista. O Fornecedor de SMS deve ter permissões de controlo total para esse local.

Quando adiciona controladores de dispositivo a um pacote de controlador, o Gestor de Configuração copia-o para este caminho. Pode adicionar a um pacote de motorista apenas controladores de dispositivo que importou e que estão habilitados no catálogo do motorista.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

- ID

Especifique a identificação de um pacote de motorista para configurar. Este valor é um ID de pacote padrão, por exemplo: XYZ00020 .

Type: String
Parameter Sets: SetById
Aliases: PackageId

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

-InputObject

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

Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-MulticastAllow

Desa esta definição deste parâmetro para $true para permitir que este pacote seja transferido através de multicast. Para obter mais informações, consulte utilizar multicast para implementar Windows na rede com o Gestor de Configuração.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-MulticastEncrypt

Se ativar o MulticastAllow, desaprote este parâmetro para $true para encriptar pacotes multicast.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-MulticastTransferOnamente

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

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Especifique o nome de uma embalagem de motorista para configurar.

Type: String
Parameter Sets: SetByName
Aliases:

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

-Novo Nome

Especifique um novo nome para o pacote do motorista.

Type: String
Parameter Sets: (All)
Aliases:

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

- PassThru

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-PrestageBehavior

Especifique o comportamento quando ativar um ponto de distribuição para conteúdo satisfatório:

  • ManualCopy: Copiar manualmente o conteúdo desta embalagem para o ponto de distribuição
  • DownloadDelta: Descarregue apenas alterações de conteúdo no ponto de distribuição
  • OnDemand: Descarregue automaticamente o conteúdo quando os pacotes são atribuídos a pontos de distribuição

Para obter mais informações, consulte o conteúdo de prestaçãode informação .

Type: PrestageBehavior
Parameter Sets: (All)
Aliases:
Accepted values: ManualCopy, DownloadDelta, OnDemand

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

-Prioridade

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 média ou baixa prioridade. Pacotes com igual prioridade são enviados na ordem em que são criados.

Type: Priority
Parameter Sets: (All)
Aliases:
Accepted values: High, Medium, Low

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

-SendToPreferredDistributionPoint

Se pretender permitir a distribuição de conteúdos a pedido para pontos de distribuição preferidos, desaponte este parâmetro para $true. Quando ativa esta definição, se um cliente solicitar o conteúdo do pacote e o conteúdo não estiver disponível em quaisquer pontos de distribuição, então o ponto de gestão distribui o conteúdo. Para obter mais informações, consulte a distribuição de conteúdos a pedido.

Type: Boolean
Parameter Sets: (All)
Aliases: SendToPreferredDistributionPoints

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

-Versão

Especifique a versão do pacote do condutor. Este valor é uma corda que geres.

Type: String
Parameter Sets: (All)
Aliases:

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

Exportação-CMDriverPackage

Get-CMDriverPackage

Pacote de Produtos De Importação-CMDriver

Pacote de malas de nova CMDriver

Remove-CMDriverPackage

Gerir controladores em Gestor de Configuração