Udostępnij przez

Set-SCScript

Moduł:
VirtualMachineManager Module

Zmienia właściwości skryptu przechowywanego w bibliotece programu VMM.

Składnia

Default 

Set-SCScript
    [-Script] <Script>
    [-UserRole <UserRole>]
    [-Enabled <Boolean>]
    [-VMMServer <ServerConnection>]
    [-Name <String>]
    [-SharePath <String>]
    [-Description <String>]
    [-Owner <String>]
    [-FamilyName <String>]
    [-Release <String>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

EquivalencySet 

Set-SCScript
    [-Scripts] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]>
    -FamilyName <String>
    -Release <String>
    [-VMMServer <ServerConnection>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Opis

Polecenie cmdlet Set-SCScript zmienia co najmniej jedną właściwość skryptu przechowywanego w bibliotece programu Virtual Machine Manager (VMM).

Właściwości, które można zmienić, obejmują:

  • Opis
  • Włączone
  • Nazwa
  • Właściciel
  • Ścieżka udziału

Obiekty skryptu reprezentują pliki skryptów przechowywane w udziale bibliotecznym na serwerze biblioteki. Zazwyczaj te skrypty są skryptami programu Windows PowerShell® lub plikami odpowiedzi (takimi jak plik Sysprep.inf lub plik Unattend.xml), które zawierają dane wejściowe wymagane przez program instalacyjny systemu Windows.

Przykłady

Przykład 1: Zmienianie opisu skryptu

PS C:\> $Script = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "Sysprep.inf" }
PS C:\> Set-SCScript -Script $Script -Description "Windows Server 2008 R2 Sysprep Answer File"

Pierwsze polecenie pobiera obiekt skryptu pliku odpowiedzi o nazwie Sysprep.inf z biblioteki w programie VMMServer01, a następnie zapisuje obiekt w zmiennej $Script.

Drugie polecenie zmienia opis tego obiektu skryptu na "Windows Server 2008 R2 Sysprep Answer File".

Przykład 2: Wyłączanie skryptu programu Windows PowerShell przechowywanego w bibliotece programu VMM

PS C:\> $Script = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AddHost.ps1" }
PS C:\> Set-SCScript -Script $Script -Enabled $FALSE

Pierwsze polecenie pobiera obiekt skryptu programu PowerShell o nazwie AddHost.ps1 i zapisuje obiekt w zmiennej $Script.

Drugie polecenie wyłącza skrypt przechowywany w $Script.

Przykład 3: Określanie właściciela dla wszystkich skryptów z nieznanym właścicielem

PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCScript -Owner "Contoso\PattiFuller"

To polecenie pobiera wszystkie obiekty skryptu z biblioteki programu VMM, której właścicielem jest Nieznany, a następnie określa właściciela dla każdego obiektu skryptu.

Parametry

-Description

Określa opis skryptu.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Default
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Enabled

Włącza obiekt, gdy jest ustawiony na $True, lub wyłącza obiekt, gdy jest ustawiony na $False. Jeśli na przykład chcesz uaktualnić oprogramowanie w szablonie maszyny wirtualnej, możesz wyłączyć obiekt szablonu w bibliotece programu VMM, aby tymczasowo uniemożliwić użytkownikom korzystanie z tego obiektu.

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Default
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-FamilyName

Określa nazwę rodziny zasobu fizycznego w bibliotece programu VMM. Ta wartość jest używana w połączeniu z polami Release, Namespace i Type w celu ustanowienia równoważności między zasobami biblioteki.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Default
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Określa nazwę obiektu programu VMM.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Default
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Owner

Określa właściciela obiektu programu VMM w postaci prawidłowego konta użytkownika domeny.

  • Przykładowy format: -Owner "Contoso\PattiFuller"
  • Przykładowy format: -Owner "PattiFuller@Contoso"

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Default
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:Guid
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Release

Określa ciąg opisujący wydanie zasobu biblioteki. Program VMM automatycznie tworzy wartość wydania dla każdego zasobu zaimportowanego do biblioteki. Po zaimportowaniu zasobu ciąg można dostosować.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Default
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RunAsynchronously

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

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Script

Określa obiekt skryptu programu VMM.

Właściwości parametru

Typ:Script
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Default
Position:0
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Scripts

Określa tablicę obiektów skryptu.

Właściwości parametru

Typ:

System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

EquivalencySet
Position:0
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SharePath

Określa ścieżkę do prawidłowego udziału biblioteki na istniejącym serwerze biblioteki, który używa ścieżki Universal Naming Convention (UNC).

Przykładowy format: -SharePath \\LibServer01\LibShare.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Default
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-UserRole

Określa obiekt roli użytkownika.

Właściwości parametru

Typ:UserRole
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Default
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-VMMServer

Określa obiekt serwera programu VMM.

Właściwości parametru

Typ:ServerConnection
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wyjściowe

Script

To polecenie cmdlet zwraca obiekt Script .

Uwagi

  • Wymaga obiektu skryptu programu VMM, który można pobrać przy użyciu polecenia cmdlet Get-SCScript .