vsphere PowerCLI Installation Guide VMware vsphere PowerCLI 4.1 Update 1 EN

Transcription

1 VMware vsphere PowerCLI 4.1 Update 1 EN

2 You can find the most up-to-date technical documentation on the VMware Web site at: The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: Copyright 2010 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. VMware, Inc Hillview Ave. Palo Alto, CA VMware, Inc.

3 Contents About This Book 5 1 Before You Begin 7 Supported Platforms 7 Additional Prerequisites 8 Downloading the vsphere PowerCLI Binary 8 Connectivity Check 8 Documentation 9 2 Installing a vsphere PowerCLI Package 11 Installing vsphere PowerCLI on Windows 11 Uninstalling vsphere PowerCLI 12 3 Validating the vsphere PowerCLI Installation 13 Launching the vsphere PowerCLI Console 13 Setting the Properties to Support RemoteSigning 13 Running the Connect-VIServer Cmdlet 13 VMware, Inc. 3

4 4 VMware, Inc.

5 About This Book The vsphere PowerCLI Installation Guide provides information about installing VMware vsphere PowerCLI and validating the installation. This guide is intended for administrators who want to run.net applications and vsphere PowerCLI cmdlets on VMware vsphere hosts. Intended Audience This book is intended for anyone who needs to install vsphere PowerCLI. All users need to understand how to use.net applications and vsphere PowerCLI cmdlets on their Windows platform. VMware Technical Publications Glossary VMware Technical Publications provides a glossary of terms that might be unfamiliar to you. For definitions of terms as they are used in VMware technical documentation go to Document Feedback VMware welcomes your suggestions for improving our documentation. If you have comments, send your feedback to docfeedback@vmware.com. Technical Support and Education Resources The following sections describe the technical support resources available to you. To access the current version of this book and other books, go to Online and Telephone Support To use online support to submit technical support requests, view your product and contract information, and register your products, go to Customers with appropriate support contracts should use telephone support for the fastest response on priority 1 issues. Go to Support Offerings To find out how VMware support offerings can help meet your business needs, go to VMware, Inc. 5

6 VMware Professional Services VMware Education Services courses offer extensive hands-on labs, case study examples, and course materials designed to be used as on-the-job reference tools. Courses are available onsite, in the classroom, and live online. For onsite pilot programs and implementation best practices, VMware Consulting Services provides offerings to help you assess, plan, build, and manage your virtual environment. To access information about education classes, certification programs, and consulting services, go to 6 VMware, Inc.

7 1 Before You Begin 1 This chapter presents important prerequisites for installing vsphere PowerCLI. The chapter discusses the following topics: Supported Platforms on page 7 Additional Prerequisites on page 8 Downloading the vsphere PowerCLI Binary on page 8 Connectivity Check on page 8 Documentation on page 9 Supported Platforms VMware vsphere PowerCLI is supported on the 32-bit and 64-bit versions of the following Windows operating systems: Windows 7 Windows Server 2008 Windows Vista Windows XP Service Pack 2 Windows 2003 Server Service Pack 2 vsphere PowerCLI is compatible with the following VMware environments: VMware ESX 4.1/vCenter Server 4.1 VMware ESXi 4.1 VMware ESX 4.0 Update 1/vCenter Server 4.0 Update 1 VMware ESXi 4.0 Update 1 VMware ESX 3.5 Update 5 VMware ESXi 3.5 Update 5 VMware VirtualCenter 2.5 Update 6 VMware ESX Update 1 VMware, Inc. 7

8 Additional Prerequisites To use vsphere PowerCLI, you must have installed the following:.net 2.0 SP1 Windows PowerShell 1.0/2.0 Downloading the vsphere PowerCLI Binary Before installing PowerCLI, you need to download the PowerCLI installation binary. To download the latest version of vsphere PowerCLI 1 Go to the PowerCLI page at 2 In the VMware vsphere PowerCLI section, click Download. 3 Read and accept vsphere PowerCLI Agreement to continue. 4 Download the binary for the installation you want to perform. Connectivity Check Before you start to use vsphere PowerCLI, make sure the connection from your development system to the target ESX host or to the vcenter Server is working. The connection is required for the validation task in Chapter 3, Validating the vsphere PowerCLI Installation, on page 13. This section discusses how to connect to the target system and launch the Managed Object Browser (MOB). The MOB is a Web-based server application hosted on all ESX hosts and vcenter Server systems. The MOB lets you explore the objects on the system and obtain information about available properties and methods. It s a great tool for investigating server-side objects and for learning about the VMware Infrastructure object model. NOTE If the ESX or vcenter Server uses HTTPS (the default), you need a user name and password to log in to the MOB. To access the MOB on any ESX or vcenter Server 1 Launch a Web browser on your development system. 2 Connect to the MOB by using the fully-qualified domain name (or the IP address) of the ESX host or the vcenter Server as follows: The browser prompts you for a user name and password for the host. 3 Enter the user name and password. After you enter the user name and password, the host might display a warning message regarding the SSL certificate authority, such as Website Certified by an Unknown Authority. If VMware is the certificate authority, you can disregard such warnings and continue to log in to the MOB. NOTE If the ESX or the vcenter Server has been configured to support HTTP (not HTTPS) connections and you used http in the URL, the system does not prompt you for a user name and password, and does not display any SSL-certificate-related warnings. 8 VMware, Inc.

9 Chapter 1 Before You Begin Documentation The documentation for vsphere PowerCLI includes Administration Guide, VMware vsphere SDK for.net Developer s Guide, and Cmdlet Reference Guide available on the vsphere PowerCLI documentation page. Because your.net applications and vsphere PowerCLI cmdlets retrieve and work with server-side objects, it is also essential that you understand the VMware vsphere SDK. The vsphere SDK for.net Reference Guide is included with the vsphere PowerCLI installation. Some users might find the vsphere SDK Programming Guide helpful. It is available from the SDK download site at VMware, Inc. 9

10 10 VMware, Inc.

11 2 Installing a vsphere PowerCLI 2 Package This chapter explains how to install the vsphere PowerCLI package on Windows. After you have installed the package on your machine, you can invoke vsphere PowerCLI cmldets to connect to your ESX or vcenter Server system by specifying the appropriate connection parameters. See the vsphere PowerCLI Administration Guide for a list of connection parameters you can use. This chapter discusses the following topics: Installing vsphere PowerCLI on Windows on page 11 Uninstalling vsphere PowerCLI on page 12 Installing vsphere PowerCLI on Windows You can install the vsphere PowerCLI package on the following 32-bit and 64-bit Windows platforms: Windows Vista Windows XP SP 2 Windows 2003 Server SP 2 CAUTION The vsphere PowerCLI installer does not include installation of Windows PowerShell. Before initializing the installation of vsphere PowerCLI, make sure that you have Windows PowerShell installed on the target Windows system. To install vsphere PowerCLI using the Windows installer 1 Launch the installer by double-clicking the executable file you downloaded. See Downloading the vsphere PowerCLI Binary on page 8. 2 Click Next in the Welcome page to continue with the installation. 3 Read and accept the license agreement terms. 4 Click Next. The Destination Folder page appears. 5 If you do not want to install the vsphere PowerCLI in the default location, click Change and select a different directory. The default location is: C:\Program Files\VMware\Infrastructure\vSphere PowerCLI 6 Click Next. 7 In the Ready to Install the Program page choose whether to create a desktop shortcut. 8 Click Install to proceed with the installation. Click Finish to complete the installation process. VMware, Inc. 11

12 If the PowerShell Execution Policy on your machine is set incorrectly, a warning message appears before finalizing the vsphere PowerCLI installation. Ignore it and continue with the installation. To find more information about the PowerShell Execution Policy, see Setting the Properties to Support RemoteSigning on page 13. After the installation is completed, you can test it by running one of the sample scripts. See Chapter 3, Validating the vsphere PowerCLI Installation, on page 13. Uninstalling vsphere PowerCLI To uninstall the vsphere PowerCLI from your Windows system use the Add or Remove Programs control panel. 12 VMware, Inc.

13 3 Validating the vsphere PowerCLI 3 Installation This chapter explains how to launch the vsphere PowerCLI console and validate the installation by running vsphere PowerCLI cmdlets. This chapter discusses the following topics: Launching the vsphere PowerCLI Console on page 13 Setting the Properties to Support RemoteSigning on page 13 Running the Connect-VIServer Cmdlet on page 13 Launching the vsphere PowerCLI Console You can launch the vsphere PowerCLI console in one of two ways: from the Start menu, or through the desktop icon. To launch the vsphere PowerCLI console from the Start menu Choose Start > Programs > VMware > VMware vsphere PowerCLI > VMware vsphere PowerCLI The vsphere PowerCLI console window opens. Setting the Properties to Support RemoteSigning For security reasons, Windows PowerShell supports an execution policy feature. It determines whether scripts are allowed to run and whether they must be digitally signed. By default, the execution policy is set to Restricted, which is the most secure policy. If you want to run scripts or load configuration files, you can change the execution policy by using the Set-ExecutionPolicy cmdlet. To do this, in the vsphere PowerCLI console window, type the following: Set-ExecutionPolicy RemoteSigned If the command is successful, you will be able to run scripts and load configuration files. To get more information about the execution policy and script digital signing in Windows PowerShell 1.0, use the following command: Get-Help About_Signing Running the Connect-VIServer Cmdlet To verify that vsphere PowerCLI is properly installed, you can try to get access to a vsphere server. In the vsphere PowerCLI console window type the following pipeline cmdlet: Connect-VIServer -Server <server_address> -Protocol <hypertext_transfer_protocol> -User <user_name> -Password <password> VMware, Inc. 13

14 Where <server_address> is the IP address or the DNS name of the target VI server and <HyperText_Transfer_Protocol> can be http or https. For example: Connect-VIServer -Server Protocol https -User Administrator -Password connect After you execute the Connect-VIServer cmdlet, you might receive warning messages regarding server certificates. If your certification authority is VMware, you can disregard these warnings. You are now ready to manage VMware vsphere server-side objects using the vsphere PowerCLI cmdlets. 14 VMware, Inc.