Compartilhar via


Clear-CMPxeDeployment

Limpa o estado da implementação PXE mais recente no Configuration Manager.

Sintaxe

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 estado da implementação mais recente do Ambiente de Pré-Arranque EXecution (PXE) no Configuration Manager.

Pode reimplementar uma implementação PXE necessária para uma coleção de dispositivos. Limpe o estado da última implementação PXE atribuída a essa coleção do Configuration Manager. O Configuration Manager reimplementa as implementações necessárias mais recentes.

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: Limpar uma implementação PXE para uma coleção de dispositivos

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

Este comando limpa uma implementação PXE identificada com um ID de coleção de dispositivos.

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

-Device

Especifica um objeto de dispositivo. Para obter um objeto de dispositivo, utilize o cmdlet Get-CMDevice .

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

-DeviceCollection

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

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

-DeviceCollectionId

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

Tipo:String[]
Aliases:CollectionId, DeviceCollectionIds, CollectionIds
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeviceCollectionName

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

Tipo:String[]
Aliases:CollectionName, DeviceCollectionNames, CollectionNames
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeviceName

Especifica uma matriz de nomes de dispositivos.

Tipo:String[]
Aliases:DeviceNames
Cargo:Named
Valor padrão:None
Obrigatório:True
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

-ResourceId

Especifica uma matriz de IDs para recursos. O cmdlet limpa o estado da implementação PXE para estes recursos.

Tipo:Int32[]
Aliases:ResourceIds
Cargo:Named
Valor padrão:None
Obrigatório:True
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