Udostępnij za pośrednictwem

Remove-SCScript

  • Odwołanie
Moduł:
VirtualMachineManager

Usuwa obiekt skryptu z programu VMM.

Składnia

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

Opis

Polecenie cmdlet Remove-SCScript usuwa co najmniej jeden obiekt skryptu z biblioteki programu VMM i usuwa odpowiedni plik skryptu na serwerze biblioteki.

Jeśli skrypt jest dołączony do szablonu lub profilu sprzętu (i jeśli nie używasz parametru Force ), program Virtual Machine Manager (VMM) wyświetla kontener zawierający skrypt i monituje o potwierdzenie usunięcia skryptu:

  • Jeśli odpowiesz tak, program VMM usunie skojarzenie między skryptem a kontenerem, do którego jest dołączony, a następnie usunie obiekt script z programu VMM.
  • Jeśli odpowiesz nie, operacja zostanie anulowana.

To polecenie cmdlet zwraca obiekt po powodzeniu (z właściwością MarkedForDeletion ustawioną na $True) lub zwraca komunikat o błędzie po niepowodzeniu.

Przykłady

Przykład 1. Usuwanie obiektu skryptu i usuwanie odpowiedniego pliku skryptu

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

Pierwsze polecenie pobiera obiekt skryptu o nazwie AddHost.ps1 z biblioteki programu VMM na serwerze VMMServer01 i przechowuje obiekt w tablicy o nazwie $Scripts. Więcej niż jeden plik o tej samej nazwie może istnieć, jeśli na określonym serwerze biblioteki istnieje więcej niż jeden kontener skryptów.

Drugie polecenie zlicza liczbę skryptów w $Scrips i wyświetla wyniki użytkownikowi.

Trzecie polecenie przekazuje każdy obiekt skryptu w $Scripts do polecenia cmdlet Select-Object, które wybiera nazwę i ścieżkę udziału dla każdego skryptu w tablicy. Następnie polecenie przekazuje te wyniki do polecenia cmdlet Format-List, aby wyświetlić każdą nazwę skryptu i jego ścieżkę udziału do użytkownika.

Ostatnie polecenie usuwa pierwszy obiekt w tablicy $Scripts i używa parametru Force , aby upewnić się, że obiekt skryptu zostanie usunięty z bazy danych programu VMM, a odpowiedni plik skryptu zostanie usunięty z systemu plików na serwerze biblioteki.

Przykład 2. Usuwanie wielu skryptów z biblioteki

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

Pierwsze polecenie pobiera wszystkie obiekty skryptu, których nazwy zawierają ciąg "Sysprep" z programu VMMServer01, a następnie przechowuje te obiekty w tablicy o nazwie $Scripts.

Drugie polecenie przekazuje każdy obiekt skryptu w $Scripts do polecenia Remove-SCScript, który usuwa każdy obiekt skryptu z biblioteki i usuwa każdy odpowiedni plik skryptu z systemu plików na serwerze biblioteki.

Parametr Confirm monituje o potwierdzenie, że chcesz usunąć te skrypty. Istnieje możliwość potwierdzenia usunięcia wszystkich skryptów jednocześnie lub potwierdzenia usunięcia każdego skryptu jeden po drugim.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

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

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.

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

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

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

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

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

-Script

Określa obiekt skryptu programu VMM.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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