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 chiede di confermare che si vuole rimuovere lo script:

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

Questo cmdlet restituisce l'oggetto in caso di esito positivo (con la proprietà MarkedForDeletion impostata su $True) o restituisce un messaggio di errore in caso di 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 sono presenti più contenitori con lo stesso nome, potrebbero esistere più di un contenitore per gli script.

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 $Scripts e usa il parametro Force per assicurarsi che l'oggetto script venga rimosso dal database VMM e che 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 alla volta.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobVariable

Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PROTipID

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

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Script

Specifica un oggetto script VMM.

Tipo:Script
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False