Get-Datacenter
This cmdlet retrieves the datacenters available on a vCenter Server system. Returns a set of datacenters that correspond to the filter criteria defined by the cmdlet parameters. By default, the cmdlet searches recursively from any provided starting point. In this case, if the location is not explicitly specified, the search includes the root folder and all other inventory items on the root folder level. If the command runs with the NoRecursion parameter set to $true, and the location is not specified, only the root folder is searched and no datacenters are returned. To specify a server different from the default one, use the Server parameter.
Syntax
Parameters
Required | Parameter Name | Type | Position | Features | Description |
---|---|---|---|---|---|
required
|
Id | String[] | named |
|
Specifies the IDs of the datacenters you want to retrieve. Note: When a list of values is specified for the Id parameter, the returned objects would have an ID that matches exactly one of the string values in that list. |
optional | ProgressAction | ActionPreference | named |
|
|
optional | Server | VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer. |
Output
VMware.VimAutomation.ViCore.Types.V1.Inventory.DatacenterExamples
Example 1
Get-Datacenter -Name Datacenter*
Retrieves a list of all datacenters on the server, whose names begin with "Datacenter".
Related Commands
Datacenter
This cmdlet retrieves the datacenters available on a vCenter Server system.
This cmdlet moves a vCenter Server datacenter from one location to another.
This cmdlet creates a new datacenter.
This cmdlet removes the specified datacenters from their locations.
This cmdlet modifies the properties of the specified datacenter.