Partilhar via

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 VMM e elimina o ficheiro de script correspondente no servidor da biblioteca.

Se o script estiver ligado a um modelo ou perfil de hardware (e se não utilizar o parâmetro Force ), o Gestor de Máquinas Virtuais (VMM) lista o recipiente que contém o script e pede-lhe que confirme que pretende remover o script:

  • Se responder Sim, o VMM remove a associação entre o script e o recipiente ao qual está ligado e, em seguida, elimina o objeto de script do VMM.
  • Se responder não, a operação será cancelada.

Este cmdlet devolve o objeto após o sucesso (com a propriedade marcada para $True) ou devolve uma mensagem de erro após falha.

Exemplos

Exemplo 1: Remover um objeto de script e eliminar o ficheiro 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 nomeado AddHost.ps1 da biblioteca VMM no VMMServer01 e armazena o objeto na matriz chamada $Scripts. Mais de um ficheiro com o mesmo nome pode existir se existir mais de um recipiente para scripts no servidor de biblioteca especificado.

O segundo comando conta o número de scripts em $Scrips e apresenta os resultados ao utilizador.

O terceiro comando transmite cada objeto de script em $Scripts para o Select-Object cmdlet, que seleciona o nome e partilha o caminho para cada script na matriz. Em seguida, o comando transmite estes resultados ao Format-List cmdlet para mostrar cada nome do script, e o seu caminho de partilha, para o utilizador.

O último comando elimina o primeiro objeto na matriz $Scripts e utiliza o parâmetro Force para garantir que o objeto de script é removido da base de dados VMM e que o ficheiro de script correspondente é eliminado do sistema de ficheiros no servidor da 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 "Sysprep" da VMMServer01 e, em seguida, armazena estes objetos na matriz chamada $Scripts.

O segundo comando transmite cada objeto de script em $Scripts para Remover-SCScript, que remove cada objeto de script da biblioteca e elimina cada ficheiro de script correspondente do sistema de ficheiros no servidor da biblioteca.

O parâmetro Confirmar solicita-lhe que confirme que pretende remover estes scripts. Tem a opção de confirmar a eliminação de todos os scripts de uma vez ou confirmar a eliminação de cada script um a um.

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

-Force

Força o comando a funcionar sem pedir confirmação do utilizador.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-Script

Especifica um objeto de script VMM.

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