Bereits seit Ende Januar 2017 ist die neue Version 4.0 unserer PowerShell Extensions for HEAT Client Management verfügbar - leider komme ich erst jetzt dazu, einen Blog-Artikel darüber zu schreiben, der die Neuerungen und Verbesserungen gegenüber der Vorgängerversion verdeutlicht. Neben 40 komplett neuen Cmdlets wurden sowohl zusätzliche Parameter für bereits bestehende Cmdlets, zusätzliche Methoden für Objekte und Performance-Verbesserungen implementiert. Außerdem wurden einige (wenige) interne Fehler behoben.
Dieser Blog-Artikel listet die Veränderungen im Detail.
Neue Cmdlets
Die auffälligste Neuerung sind sicherlich die 40 neuen Cmdlets, die den Umgang mit den Objekten der DSM Umgebung noch einfacher und effizienter machen.
Die erste Kategorie betrifft das Handling der DSM Powershell-Laufwerke, das in der Vergangenheit über die Standard-Cmdlets New-PSDrive, Get-PSDrive und Remove-PSDrive durchgeführt werden musste. Dabei war es stets erforderlich, den PowerShell-Provider BlsEmdb anzugeben. Mit PSX 4.0 haben wir nun mit dedizierten Cmdlets die Möglichkeit geschaffen, solche "Emdb-Laufwerke" leichter zu verwalten. Es stehen dafür New-EmdbDrive, Get-EmdbDrive und Remove-EmdbDrive zur Verfügung.
Die zweite große Kategorie und mit 34 Cmdlets auch die größte Gruppe sind Test-Cmdlets, die auf bestimmte Dinge wie Existenz von Objekten, Gruppenmitgliedschaft, Compliance, Variablen- und Parameterwerte oder ähnliches prüfen. Die Parameter dieser Cmdlets entsprechen jenen der zugehörigen Get-... Cmldets und sie liefern $true, wenn die angegebenen Bedingungen für die gesamte angeforderte Ergebnismenge zutreffen. Wird bei den Test-Cmdlets zusätzlich der Parameter -Any angegenben, so wird $true zurückgegeben, wenn mindestens ein Element der angeforderten Ergebnismenge den angegebenen Bedingungen entspricht.
Beispiele:
Test-EmdbComputer COMPUTER01, COMPUTER02
Liefert $true, wenn COMPUTER01 und COMPUTER02 vorhanden sind
Test-EmdbComputer COMPUTER01, COMPUTER02 -Any
Liefert $true, wenn mindestens COMPUTER01 oder COMPUTER02 vorhanden sind
Der Vollständigkeit halber sind noch die drei neuen Cmdlets Get-EmdbComplianceState, Get-EmdbItem und Add-EmdbRelatedItem zu nennen. Get-EmdbComplianceState liefert Compliance-Statuswerte für Computer, Policies, Policy-Instanzen und Zuweisungsziele. Get-EmdbItem liefert jede Art von EmdbItem-Objekt, was insbesondere bei der interaktiven Arbeit mit den PSX in der PowerShell Console oder der PowerShell ISE nützlich sein kann und Tipparbeit erspart. Uns schließlich sorgt Add-EmdbRelatedItem dafür, dass zugehörige Objekte für gegebene Objekte - z.B. zugewiesene Software und Zuweisungsziele für Policy-Instanz-Objekte - möglichst effizient ermittelt werden.
Details zur Verwendung der neuen Cmdlets und Beispiele für den Einsatz finden Sie im jeweiligen Abschnitt der Online-Hilfe.
Neue Parameter
Für New-EmdbDrive und New-PSDrive gibt es den zusätzlichen Parameter -BlsClientName, mit dem der Anwendungsname angegeben werden kann, der beispielsweise im IIS-Log (als User-Agent) und im bls_AdministrationWebService.log zu finden ist. Damit kann in diesen Logs eindeutig identifiziert werden, welche Aktionen über PSX ausgeführt wurden beziehungsweise welche nicht. Optional kann eine Version angegeben werden, die separat abgelegt wird, im Format "<Name><Leerzeichen><Version>", die dann auch über die Eigenschaft BlsEmdbDriveInfo.ClientInfo verfügbar sind.
Die Cmdlets Get-EmdbRole und Get-EmdbPermission haben neue Parameter erhalten, die es ermöglichen, Berechtigungen zu ermitteln. Für Get-EmdbRole sind dies die Parameter -Permission, -Grantee, -OnObject, -OnGlobal, -Drive, -EffectiveRoleOwners und -ReturnAssociations, für Get-EmdbPermission sind es -Role, -Grantee, -OnObject, -OnGlobal, -Drive, -EffectiveRoleOwners und -ReturnAssociations. Zusätzliche wurden für Get-EmdbPermission die Parameter -LoggedOnUser und -ReturnTags implementiert, die es ermöglichen, Berechtigungen des aktuell am BLS angemeldeten Benutzerkontos zu ermitteln.
Änderungen an Parametern
Der in der PSX-Version 3.1 eingeführte Parameter -ItemId an den Get-Cmdlets akzeptiert jetzt auch eine Liste von Objekten beziehungsweise IDs.
Online-Hilfe
Seit PowerShell 3.0 gibt es das Cmldet Update-Help, das die Aktualisierung der in der Shell und der ISE verfügbaren Online-Hilfe über das Internet erlaubt. Mit PSX 4.0 haben wir nun auch die Möglichkeit geschaffen, die Hilfe über das Internet von unserem Webserver zu aktualisieren. Der hierzu notwendige Befehl lautet Update-Help -Module PSX7
Zusätzliche Methoden
- EmdbPolicy.NewPolicyInstance(<EmdbComputer>)
Erzeugt eine neue Instanz von EmdbPolicyInstance (Anlegen auf BLS mit EmdbPolicyInstance.Create()) - BlsEmdbDriveInfo.UpdateEmdbItems(<Liste von EmdbItem>)
Aktualisiert alle angegebenen Objekte bei einem Aufruf. Vorteil gegenüber .Update() für jedes einzelne Objekt: Nutzt (wenn anwendbar) die SOAP-APIs für Objektlisten, Nachteil (oder Feature, je nachdem): Fehler, und damit keine Änderungen, wenn die Aktualisierung eines Listenelements fehlschlägt - EmdbGroup.GetMemberCount()
Liefert die Anzahl der Gruppenmitglieder - EmdbExternalGroup.GetMemberCount()
Liefert die Anzahl der Gruppenmitglieder - EmdbSoftware.GetReplaceables(…)
Liefert die Revisionen dieser Software und andere Software mit übereinstimmender Replacement-ID. Ein optionaler Parameter ermöglicht Einschränkungen der Ergebnismenge - EmdbPolicy.UpdateTo(…)
Aktualisiert die Policy auf eine andere Revision oder eine andere Software mit übereinstimmender Replacement-ID. Mehrere Varianten mit unterschiedlichen Parametersätzen - EmdbObject.GetVariableValue
EmdbObject.GetVariableValues
Ermitteln Variablenwerte - EmdbObject.SetVariableValue
EmdbObject.SetVariableValues
Setzen Variablenwerte - EmdbAssociation.GetSourceObject
Ersetzt die gleichnamige Skript-Methode (Unterschied: Objekt wird zwischengespeichert) - EmdbAssociation.GetTargetObject
Ersetzt die gleichnamige Skript-Methode (Unterschied: Objekt wird zwischengespeichert) - EmdbPolicyInstance.GetTargetObject
Ersetzt die gleichnamige Skript-Methode (Unterschied: Objekt wird zwischengespeichert) - EmdbPolicy.GetTargetObjects
Ersetzt die gleichnamige Skript-Methode (Unterschied: Objekte werden zwischengespeichert) - EmdbItem.GetDereferencedPropertyValue
Liefert die referenzierten Objekte zur angegebenen Eigenschaft - EmdbItem.GetLocalizedPropertyValue
Liefert den Wert der angegebenen Eigenschaft als LocalizedString Objekt - EmdbItem.SetLocalizedPropertyValue
Setzt den LocalizedString Objekt Wert der angegebenen Eigenschaft
Zusätzliche Skript-Methoden
- EmdbPolicy.ActivateAllInstances
Setzt 'IsActive = $true' für alle (nicht aktiven) Policy-Instanzen der Policy - EmdbPolicy.DeactivateAllInstances
Setzt 'IsActive = $false' für alle (aktiven) Policy-Instanzen der Policy - EmdbPolicy.GetReplaceableSoftware
Verwendet EmdbSoftware.GetReplaceables der zugewiesenen Software
Zusätzliche Skript-Eigenschaften
- EmdbExternalGroup.ExternalGroupType
Liefert den Wert von "ExternalGroup.GroupType" (im Gegensatz dazu liefert .GroupType den Wert von Object.GroupType)
Weggefallene Skript-Methoden
- EmdbSoftwareInstallationConfiguration.GetSoftwareObject
Überflüssig, da es bereits eine Methode EmdbSoftwareInstallationConfiguration.GetSoftware() gibt
Sonstiges
- Umbenennung der Skript-Methode EmdbPolicyInstance.GetShoppedByItem zu Skript-Methode EmdbPolicyInstance.GetShoppedByItems
- Fehlerbehebung Skript-Methode EmdbPolicyInstance.GetShoppedByItem bzw. .GetShoppedByItems
Fehler beim Aufruf, da PolicyInstanceClient.ShoppedBy wie ein einzelner Int32-Wert behandelt wird - Fehlerbehebung Skript-Methode EmdbEffectiveRoleOwners.GetOriginalTargetObject
Liefert das Objekt zur Eigenschaft TargetObjectId (anstatt zur Eigenschaft OriginalTargetSchemaTag)
Errata
Aufgrund der Möglichkeit des Online-Updates der Hilfe ist nicht, wie in der mitgelieferten Online-Hilfe aufgeführt, Version 2.0 der PowerShell Mindestvoraussetzung, sondern PowerShell Version 3.0 - zumindest wenn Sie die PSX, wie mittlerweile allgemein üblich, als Module per Import-Module laden. Versuchen Sie dies mit PowerShell 2.0 erhalten Sie einen Fehler.