Share via


Clear-CMPxeDeployment

Limpa o status da implantação PXE mais recente no Configuration Manager.

Syntax

Clear-CMPxeDeployment
     -DeviceCollection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-CMPxeDeployment
     -Device <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-CMPxeDeployment
     -DeviceCollectionId <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-CMPxeDeployment
     -DeviceCollectionName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-CMPxeDeployment
     -DeviceName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-CMPxeDeployment
     -ResourceId <Int32[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

O cmdlet Clear-CMPxeDeployment limpa o status da implantação mais recente do Ambiente de EXecution de Pré-Inicialização (PXE) no Configuration Manager.

Você pode reimplantar uma implantação PXE necessária para uma coleção de dispositivos. Limpe o status da última implantação PXE atribuída a essa coleção do Configuration Manager. O Configuration Manager reimplanta as implantações necessárias mais recentes.

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: limpar uma implantação PXE para um conjunto de dispositivos

PS XYZ:\>Clear-CMPxeDeployment -DeviceCollectionId "SMS00072"

Este comando limpa uma implantação PXE identificada com uma ID de conjunto de dispositivos.

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

-Device

Especifica um objeto device. Para obter um objeto device, use o cmdlet Get-CMDevice.

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

-DeviceCollection

Especifica um objeto de coleção de dispositivos. Para obter um objeto de coleção de dispositivos, use o cmdlet Get-CMDeviceCollection.

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

-DeviceCollectionId

Especifica uma matriz de IDs de coleções de dispositivos.

Type:String[]
Aliases:CollectionId, DeviceCollectionIds, CollectionIds
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeviceCollectionName

Especifica uma matriz de nomes de coleções de dispositivos.

Type:String[]
Aliases:CollectionName, DeviceCollectionNames, CollectionNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeviceName

Especifica uma matriz de nomes de dispositivos.

Type:String[]
Aliases:DeviceNames
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

-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

-ResourceId

Especifica uma matriz de IDs para recursos. O cmdlet limpa o status da implantação PXE para esses recursos.

Type:Int32[]
Aliases:ResourceIds
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