Sdílet prostřednictvím

Set-SCScript

  • Reference
Modul:
VirtualMachineManager

Změní vlastnosti skriptu uloženého v knihovně VMM.

Syntaxe

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

Description

Rutina Set-SCScript změní jednu nebo více vlastností skriptu uloženého v knihovně nástroje Virtual Machine Manager (VMM).

Mezi vlastnosti, které můžete změnit, patří:

  • Popis
  • Zpřístupněný
  • Jméno
  • Vlastník
  • SharePath

Objekty skriptu představují soubory skriptu uložené ve sdílené složce knihovny na serveru knihovny. Tyto skripty jsou obvykle buď skripty Windows PowerShellu®, nebo soubory odpovědí (například Sysprep.inf nebo soubor Unattend.xml), které obsahují vstupy požadované pro instalační program systému Windows.

Příklady

Příklad 1: Změna popisu skriptu

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"

První příkaz načte objekt skriptu souboru odpovědí s názvem Sysprep.inf z knihovny na VMMServer01 a pak uloží objekt do proměnné $Script.

Druhý příkaz změní popis tohoto objektu skriptu na "Windows Server 2008 R2 Sysprep Answer File".

Příklad 2: Zakázání skriptu Windows PowerShellu uloženého v knihovně 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

První příkaz získá objekt skriptu PowerShellu s názvem AddHost.ps1 a uloží objekt do proměnné $Script.

Druhý příkaz zakáže skript uložený v $Script.

Příklad 3: Určení vlastníka pro všechny skripty s neznámým vlastníkem

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

Tento příkaz získá všechny objekty skriptu z knihovny VMM, jejíž vlastník je Neznámý, a pak určuje vlastníka pro každý objekt skriptu.

Parametry

-Description

Určuje popis skriptu.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Enabled

Povolí objekt při nastavení $True nebo zakáže objekt, pokud je nastaven na $False. Pokud například chcete upgradovat software na šabloně virtuálního počítače, můžete objekt šablony v knihovně VMM zakázat, aby uživatelé tento objekt dočasně nemohli používat.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FamilyName

Určuje název rodiny pro fyzický prostředek v knihovně VMM. Tato hodnota se používá ve spojení s verzí, oborem názvů a typem k navázání ekvivalence mezi prostředky knihovny.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název objektu VMM.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Owner

Určuje vlastníka objektu VMM ve formě platného uživatelského účtu domény.

  • Příklad formátu: -Owner "Contoso\PattiFuller"
  • Příklad formátu: -Owner "PattiFuller@Contoso"
Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Release

Určuje řetězec, který popisuje vydání prostředku knihovny. Nástroj VMM automaticky vytvoří hodnotu verze pro každý prostředek importovaný do knihovny. Po importu prostředku je možné řetězec přizpůsobit.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Script

Určuje objekt skriptu VMM.

Typ:Script
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Scripts

Určuje pole objektů skriptu.

Typ:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SharePath

Určuje cestu k platné sdílené složce knihovny na existujícím serveru knihovny, který používá cestu UNC (Universal Naming Convention).

Příklad formátu: -SharePath \\LibServer01\LibShare.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UserRole

Určuje objekt role uživatele.

Typ:UserRole
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VMMServer

Určuje objekt serveru VMM.

Typ:ServerConnection
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

Script

Tato rutina vrátí objekt Script.

Poznámky

  • Vyžaduje objekt skriptu VMM, který lze načíst pomocí rutiny Get-SCScript.