Remove-SCScript

  • Referência
Módulo:
VirtualMachineManager

Remove um objeto de script do VMM.

Syntax

Remove-SCScript
      [-Script] <Script>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-SCScript remove um ou mais objetos de script da biblioteca do VMM e exclui o arquivo de script correspondente no servidor de biblioteca.

Se o script estiver anexado a um modelo ou perfil de hardware (e se você não usar o parâmetro Force ), o VMM (Virtual Machine Manager) listará o contêiner que contém o script e solicitará que você confirme que deseja remover o script:

  • Se você responder Sim, o VMM removerá a associação entre o script e o contêiner ao qual ele está anexado e, em seguida, excluirá o objeto script 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 a falha.

Exemplos

Exemplo 1: remover um objeto de script e excluir o arquivo de script correspondente

PS C:\> $Scripts = @(Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AddHost.ps1"} )
PS C:\> $Scripts.Count
PS C:\> $Scripts | select Name,SharePath | Format-List
PS C:\> Remove-SCScript -Script $Scripts[0] -Force

O primeiro comando obtém o objeto de script chamado AddHost.ps1 da biblioteca do VMM no VMMServer01 e armazena o objeto na matriz chamada $Scripts. Mais de um arquivo com o mesmo nome poderá existir se houver mais de um contêiner para scripts no servidor de biblioteca especificado.

O segundo comando conta o número de scripts em $Scrips e exibe os resultados para o usuário.

O terceiro comando passa cada objeto de script em $Scripts para o cmdlet Select-Object, que seleciona o nome e o caminho de compartilhamento para cada script na matriz. Em seguida, o comando passa esses resultados para o cmdlet Format-List para exibir cada nome de script e seu caminho de compartilhamento para o usuário.

O último comando exclui o primeiro objeto na matriz $Scripts e usa o parâmetro Force para garantir que o objeto script seja removido do banco de dados do VMM e que o arquivo de script correspondente seja excluído do sistema de arquivos no servidor de biblioteca.

Exemplo 2: remover vários scripts da biblioteca

PS C:\> $Scripts = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "Sysprep" }
PS C:\> $Scripts | Remove-SCScript -Confirm

O primeiro comando obtém todos os objetos de script cujos nomes incluem a cadeia de caracteres "Sysprep" do VMMServer01 e armazena esses objetos na matriz chamada $Scripts.

O segundo comando passa cada objeto de script em $Scripts para Remove-SCScript, que remove cada objeto de script da biblioteca e exclui cada arquivo de script correspondente do sistema de arquivos no servidor de biblioteca.

O parâmetro Confirm solicita que você confirme se deseja remover esses scripts. Você tem a opção de confirmar a exclusão de todos os scripts ao mesmo tempo ou confirmar a exclusão de cada script um por um.

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

-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

-Script

Especifica um objeto de script do VMM.

Type:Script
Position:0
Default value:None
Required:True
Accept pipeline input:True
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