Compartilhar via

Remove-SCGuestOSProfile

  • Referência
Módulo:
VirtualMachineManager

Remove um objeto de perfil do sistema operacional convidado do VMM.

Sintaxe

Remove-SCGuestOSProfile
      [-GuestOSProfile] <GuestOSProfile>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-SCGuestOSProfile remove um ou mais objetos de perfil do sistema operacional convidado da biblioteca do VMM.

Esse cmdlet retorna o objeto após o sucesso (com a propriedade MarkedForDeletion definida como True) ou retorna uma mensagem de erro após a falha.

Exemplos

Exemplo 1: remover um perfil específico do sistema operacional convidado da biblioteca

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Remove-SCGuestOSProfile -GuestOSProfile $OSProfile -Confirm

O primeiro comando obtém o objeto de perfil do sistema operacional convidado chamado NewOSProfile01 e armazena o objeto na variável $OSProfile.

O segundo comando remove o perfil do sistema operacional convidado armazenado em $OSProfile, solicitando confirmação antes de concluir a operação.

Exemplo 2: remover todos os perfis do sistema operacional sem ser solicitado a confirmar cada exclusão

PS C:\> $OSProfiles = Get-SCGuestOSProfile -VMMServer "VMMServer01.Contoso.com"
PS C:\> $OSProfiles | Remove-SCGuestOSProfile

O primeiro comando obtém todos os objetos de perfil do sistema operacional do VMMServer01 e armazena os objetos na matriz de objetos $OSProfiles.

O segundo comando passa cada objeto em $OSProfiles para o cmdlet Remove-OSProfile , que remove cada um dos objetos de perfil do sistema operacional convidado da biblioteca do VMM.

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

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

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

-GuestOSProfile

Especifica um objeto de perfil do sistema operacional convidado.

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

-JobVariable

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

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

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

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

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

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

-WhatIf

Mostra 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

Observações

  • Requer um objeto de perfil do sistema operacional convidado do VMM, que pode ser recuperado usando o cmdlet Get-SCGuestOSProfile .