Partilhar via

Remove-SCHardwareProfile

  • Referência
Módulo:
VirtualMachineManager

Remove um objeto de perfil de hardware da biblioteca VMM.

Syntax

Remove-SCHardwareProfile
      [-HardwareProfile] <HardwareProfile>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-SCHardwareProfile remove um ou mais objetos de perfil de hardware da biblioteca VMM.

Este cmdlet devolve o objeto após o sucesso com a propriedade MarkedForDeletion definida para $True, ou devolve uma mensagem de erro após falha.

Exemplos

Exemplo 1: Remover um perfil de hardware específico da biblioteca

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01"}
PS C:\> Remove-SCHardwareProfile -HardwareProfile $HWProfile -Confirm

O primeiro comando obtém o objeto de perfil de hardware chamado NewHWProfile01 da biblioteca VMM e armazena o objeto na variável $HWProfile.

O segundo comando elimina o NewHWProfle01 da biblioteca, solicitando ao utilizador a confirmação antes de concluir a operação.

Exemplo 2: Remover todos os perfis de hardware sem ser solicitado a confirmar cada eliminação

PS C:\> Get-SCHardwareProfile | Remove-SCHardwareProfile

Este comando obtém todos os objetos de perfil de hardware na biblioteca e passa cada objeto de perfil para o cmdlet Remove-SCHardwareProfile , que remove cada perfil de hardware. Ao não utilizar o parâmetro Confirmar , não é solicitado que confirme se elimina estes objetos de perfil de hardware.

Parâmetros

-Confirm

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

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

-HardwareProfile

Especifica um objeto de perfil de hardware.

Type:HardwareProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-JobVariable

Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por este parâmetro.

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

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Notas

  • Requer um objeto de perfil de hardware VMM, que pode ser recuperado utilizando o cmdlet Get-SCHardwareProfile .