Compartilhar via

Remove-SCISO

  • Referência
Módulo:
VirtualMachineManager

Remove um arquivo ISO da biblioteca do VMM.

Sintaxe

Remove-SCISO
      [-ISO] <ISO>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-SCISO remove um arquivo ISO da biblioteca do VMM (Virtual Machine Manager) e exclui o arquivo ISO no servidor de biblioteca.

Se o ISO estiver anexado a uma máquina virtual, modelo ou perfil de hardware e se você não especificar o parâmetro Forçar, o VMM listará o contêiner que inclui o ISO e solicitará que você confirme que deseja remover o ISO:

  • Se você responder Sim, o VMM removerá a associação entre o ISO e o contêiner ao qual ele está anexado e excluirá o objeto ISO do VMM.

  • Se você responder Não, a operação será cancelada.

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

Exemplos

Exemplo 1: remover um objeto ISO e excluir o arquivo .iso correspondente

PS C:\> $ISO = Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "OsISO.iso" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Remove-SCISO -ISO $ISO

O primeiro comando obtém o objeto ISO chamado OsISO.iso de LibraryServer01 e armazena o objeto ISO na variável $ISO.

O segundo comando remove o objeto ISO da biblioteca e exclui o arquivo .iso correspondente do sistema de arquivos no servidor de biblioteca.

Exemplo 2: remover vários objetos ISO da biblioteca

PS C:\> $ISOs = Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "OsISO" }
PS C:\> $ISOs | Remove-SCISO

O primeiro comando obtém todos os objetos ISO cujo nome inclui a cadeia de caracteres "OsISO" e armazena esses objetos ISO na variável $ISOs.

O segundo comando passa cada objeto ISO em $ISOs para o cmdlet Remove-SCISO , que remove cada objeto ISO da biblioteca e exclui o arquivo .iso correspondente do sistema de arquivos no servidor de biblioteca.

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

-ISO

Especifica um objeto ISO.

Tipo:ISO
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 ISO do VMM, que pode ser recuperado usando o cmdlet Get-SCISO .