Freigeben über

Set-SCScript

Modul:
VirtualMachineManager Module

Ändert die Eigenschaften eines Skripts, das in der VMM-Bibliothek gespeichert ist.

Syntax

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>]

Beschreibung

Mit dem Cmdlet Set-SCScript werden eine oder mehrere Eigenschaften eines Skripts geändert, das in der VMM-Bibliothek (Virtual Machine Manager) gespeichert ist.

Zu den Eigenschaften, die Sie ändern können, gehören:

  • BESCHREIBUNG
  • Aktiviert
  • Name
  • Besitzer
  • SharePath (Freigabepfad)

Skriptobjekte stellen Skriptdateien dar, die in einer Bibliotheksfreigabe auf einem Bibliothekserver gespeichert sind. In der Regel handelt es sich bei diesen Skripts entweder um Windows PowerShell-Skripts® oder Antwortdateien (z. B. eine Sysprep.inf oder eine Unattend.xml-Datei), die die Eingaben enthalten, die für das Windows Setup-Programm erforderlich sind.

Beispiele

Beispiel 1: Ändern der Beschreibung eines Skripts

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"

Mit dem ersten Befehl wird das Skriptobjekt der Antwortdatei mit dem Namen "Sysprep.inf" aus der Bibliothek auf VMMServer01 abgerufen und dann in der Variablen $Script gespeichert.

Mit dem zweiten Befehl wird die Beschreibung dieses Skriptobjekts in "Windows Server 2008 R2 Sysprep-Antwortdatei" geändert.

Beispiel 2: Deaktivieren eines Windows PowerShell-Skripts, das in der VMM-Bibliothek gespeichert ist

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

Der erste Befehl ruft das PowerShell-Skriptobjekt mit dem Namen AddHost.ps1 ab und speichert das Objekt in der Variablen $Script.

Der zweite Befehl deaktiviert das in $Script gespeicherte Skript.

Beispiel 3: Angeben eines Besitzers für alle Skripts mit einem unbekannten Besitzer

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

Mit diesem Befehl werden alle Skriptobjekte aus der VMM-Bibliothek abgerufen, deren Besitzer Unbekannt ist, und dann für jedes Skriptobjekt ein Besitzer angegeben.

Parameter

-Description

Gibt eine Beschreibung für das Skript an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Enabled

Aktiviert ein Objekt, wenn es auf $True gesetzt ist, oder deaktiviert ein Objekt, wenn es auf $False gesetzt ist. Wenn Sie z. B. Software für eine VM-Vorlage aktualisieren möchten, können Sie das Vorlagenobjekt in der VMM-Bibliothek deaktivieren, um vorübergehend zu verhindern, dass Benutzer dieses Objekt verwenden.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FamilyName

Gibt einen Familiennamen für eine physische Ressource in der VMM-Bibliothek an. Dieser Wert wird in Verbindung mit Release, Namespace und Type verwendet, um die Äquivalenz zwischen Bibliotheksressourcen herzustellen.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen eines VMM-Objekts an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Owner

Gibt die besitzende Person eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an.

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Release

Gibt eine Zeichenfolge an, die die Freigabe einer Bibliotheksressource beschreibt. VMM erstellt automatisch einen Releasewert für jede Ressource, die in die Bibliothek importiert wird. Nachdem die Ressource importiert wurde, kann die Zeichenfolge angepasst werden.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Script

Gibt ein VMM-Skriptobjekt an.

Parametereigenschaften

Typ:Script
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Scripts

Gibt ein Array von Skriptobjekten an.

Parametereigenschaften

Typ:

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

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

EquivalencySet
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SharePath

Gibt einen Pfad zu einer gültigen Bibliotheksfreigabe auf einem vorhandenen Bibliotheksserver an, der einen UNC-Pfad (Universal Naming Convention) verwendet.

Beispielformat: -SharePath \\LibServer01\LibShare.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UserRole

Gibt ein Benutzerrollenobjekt an.

Parametereigenschaften

Typ:UserRole
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Parametereigenschaften

Typ:ServerConnection
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

Script

Dieses Cmdlet gibt ein Script-Objekt zurück.

Hinweise

  • Erfordert ein VMM-Skriptobjekt, das mit dem Cmdlet Get-SCScript abgerufen werden kann.