How to setup the Dell Client PowerShell Provider Garg, Vibha C, Karthik
Copyright 2014 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. Dell and the Dell logo are trademarks of Dell Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. 2014 06 Table of Contents Executive summary 3 Command to check the prerequisites..4 1. Check the version of PowerShell Engine..4 2. Admin access. 4 3. Download the DellBIOSProvider from Dell website 4 4. Check if HAPI driver is installed in the system..6 5. Install the Dell PS Provider on a local system. 7 6. Load the Dell PS Provider on a remote system..8 7. Confirm if Dell BIOS Provider is installed properly.10 8. Configure the Dell BIOS settings 10
Executive summary In the recent time, Dell has announced the open beta release of a tool that can configure the BIOS settings on Precision, Latitude, Optiplex and Venue line of client systems. This tool works in the PowerShell environment and behaves like a registry provider or File provider that is natively available in PowerShell 3.0 from Microsoft. Following are the prerequisites to use this tool: 1. PowerShell 3.0 2. Admin access 3. Downloaded assemblies 4. Dell s HAPI Driver
Command to check the prerequisites 1. Check the version of PowerShell Engine Dell BIOS Provider is not compatible with PowerShell v2.0. Ensure the version compatibility by executing the following command PS C:\> $PSVersionTable.PSVersion Figure 1 Snapshot of checking the version of PowerShell Engine 2. Admin access Administrator access is required to execute the Dell BIOS Provider. Non- admin users encounter the following error while using the DellBIOSProvider. Figure 2 Snapshot of the error without admin access In that case, you need to start PowerShell with the "Run as administrator" option to get elevated privileges. 3. Download the DellBIOSProvider from Dell website. Download the Dell_SMBIOS-Provider zip file from - https://marketing.dell.com/powershell-provider-beta
Figure 3 Snapshot of files present in DellBIOSProvider Assemblies in the downloaded zip file might be blocked on the system. To unblock them, perform the following operation on Dell_SMBIOS_Provider.zip. Right Click->Properties->General->Unblock->Apply.
Figure 4 Snapshot of properties of Dell_SMBIOS_Provider The other option is to use the following PowerShell Cmdlet to unblock the file. PS C:\> Unblock-File.\Dell_SMBIOS_Provider.zip Extract the files in the zip after it is unblocked. 4. Check if HAPI driver is installed in the system. If the system has CCTK or OMCI 8.x installed, HAPI driver is already present in such systems. You can check it by executing the driverquery tool command from PowerShell console PS C:\> driverquery.exe /v /fo csv ConvertFrom-CSV Where {$_.'Module Name' -match 'Dcdbas'}
Figure 5 Snapshot of running the driver query tool command If HAPI driver needs to be installed, use the following steps. a. Unzip the HAPI_X86(*).zipx file into the working folder and navigate to it. b. Open a Command Prompt with administrative privileges and navigate to the working folder. i. Execute HAPIInstall.bat from the HAPI folder. This should install HAPI driver. Figure 6 Snapshot of running the HAPIInstall.bat file 5. Install the Dell PS Provider on a local system.
Change the directory to <Dell_SMBIOS_Provider\x86> for 32-bit Windows and <Dell_SMBIOS_Provider\x64> for 64-bit Windows. Execute the PowerShell cmd-let import-module.\dellbiosprovide.dll to add the Dell PS PowerShell provider to the current PowerShell session. PS C:\Dell_SMBIOS_Provider\x86> import-module.\dellbiosprovider.dll Figure 7 Snapshot of running the import-module If you want to have PowerSell started with provider loaded, you need to add the Importmodule cmd-let in the profile. Determine the profile location with the following command. - PS C:\> $PROFILE Format-List * -Force Figure 8 Snapshot of checking profile locations Create the profile file if it does not exist. Open the newly created profile script and add the import-module cmd-let. Now when you start the PowerShell console, Dell PS provider will be loaded automatically. Apart from this, you can use the following command from the command prompt. Powershell.exe -noexit -command "Import-Module DellBIOSProvider.dll" Note You may need to change the PowerShell execution policy if the security error File cannot be loaded appears. http://technet.microsoft.com/en-us/library/ee176961.aspx Execute the following cmdlets to check the current execution policy. PS C:\> get-executionpolicy -list 6. Load the Dell PS Provider on a remote system. When you need to execute Dell BIOS provider on a remote system, a remote interactive session needs to be established.
a. Copy the Dell SMbios Provider to the remote machine that your are going to access. b. Begin a remote interactive CIM session from Windows PowerShell console on the system. PS C:\> Enter-PSSession -ComputerName 10.94.174.169 -Credential administrator c. Notice the change in PS prompt. By this time, you should be connected to the remote system. [10.94.174.169]: PS C:\Users\Administrator\Documents> d. Navigate to the bit folder of the system (x64 or x86). e. Execute the following command i. Import-Module.\DellBIOSProvider.dll Figure 9 Snapshot of running the import-module on a remote system Note To initiate remote commands you need to check system requirements and configuration requirements in details by executing the following cmdlets. PS C:> get-help about_remote_requirements
7. Confirm if Dell BIOS Provider is installed properly A PS drive DellSmbios: is available once the Dell BIOS Provider is loaded appropriately. Check it by executing the following command - get-psdrive DellSmbios Figure 10 Snapshot of running the Dell_SMBIOS_Provider 8. Configure the Dell BIOS settings Now execution environment is ready for you to further execute the Dell BIOS provider. Leverage from the standard provider cmd-lets like cd, dir and Set-Item. For more information, you can refer to - a. Dell Client PowerShell Provider page http://en.community.dell.com/techcenter/enterprise-client/w/wiki/6901.dellclient- powershell-provider.aspx b. ReadMe.txt in downloaded zip file c. http://www.powershellmagazine.com/2014/05/12/dell-business-client-biosconfiguration-powershell-provider/ For further enquiries, please contact us over Dell Client PowerShell Provider Beta forum.