Condividi tramite

Remove-SCScript

  • Riferimento
Modulo:
VirtualMachineManager

Rimuove un oggetto script da VMM.

Sintassi

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

Descrizione

Il cmdlet Remove-SCScript rimuove uno o più oggetti script dalla libreria VMM ed elimina il file di script corrispondente nel server di libreria.

Se lo script è collegato a un modello o a un profilo hardware (e se non si usa il parametro Force ), Virtual Machine Manager (VMM) elenca il contenitore che contiene lo script e richiede di confermare che si vuole rimuovere lo script:

  • Se si risponde Sì, VMM rimuove l'associazione tra lo script e il contenitore a cui è collegato e quindi elimina l'oggetto script da VMM.
  • Se si risponde No, l'operazione viene annullata.

Questo cmdlet restituisce l'oggetto al termine dell'operazione (con la proprietà MarkedForDeletion impostata su $True) o restituisce un messaggio di errore al momento dell'errore.

Esempio

Esempio 1: Rimuovere un oggetto script ed eliminare il file di script corrispondente

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

Il primo comando ottiene l'oggetto script denominato AddHost.ps1 dalla libreria VMM in VMMServer01 e archivia l'oggetto nella matrice denominata $Scripts. Se nel server di libreria specificato esiste più di un contenitore per gli script, potrebbero essere presenti più file con lo stesso nome.

Il secondo comando conta il numero di script in $Scrips e visualizza i risultati all'utente.

Il terzo comando passa ogni oggetto script in $Scripts al cmdlet Select-Object, che seleziona il nome e il percorso di condivisione per ogni script nella matrice. Il comando passa quindi questi risultati al cmdlet Format-List per visualizzare ogni nome di script e il relativo percorso di condivisione all'utente.

L'ultimo comando elimina il primo oggetto nella matrice di $Scripts e usa il parametro Force per assicurarsi che l'oggetto script venga rimosso dal database VMM e il file di script corrispondente venga eliminato dal file system nel server di libreria.

Esempio 2: Rimuovere più script dalla libreria

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

Il primo comando ottiene tutti gli oggetti script i cui nomi includono la stringa "Sysprep" da VMMServer01 e quindi archivia questi oggetti nella matrice denominata $Scripts.

Il secondo comando passa ogni oggetto script in $Scripts a Remove-SCScript, che rimuove ogni oggetto script dalla libreria ed elimina ogni file di script corrispondente dal file system nel server di libreria.

Il parametro Confirm richiede di confermare che si desidera rimuovere questi script. È possibile confermare l'eliminazione di tutti gli script contemporaneamente o confermare l'eliminazione di ogni script uno per uno.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Specifica l'ID del suggerimento prestazioni e ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo restituisca immediatamente alla shell dei comandi.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Script

Specifica un oggetto script di VMM.

Type:Script
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False