Remove-SCGuestOSProfile
Remove um objeto de perfil do sistema operacional convidado do VMM.
Syntax
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 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 |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GuestOSProfile
Especifica um objeto de perfil do sistema operacional convidado.
Type: | GuestOSProfile |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-JobVariable
Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Observações
- Requer um objeto de perfil do sistema operacional convidado do VMM, que pode ser recuperado usando o cmdlet Get-SCGuestOSProfile .