Syntax
Get-SpbmEntityConfiguration [[-VM] <VIObject[]>] [-CheckComplianceNow] [-HardDisk <HardDisk[]>] [-Server <VIServer[]>] [-Datastore <Datastore[]>] [<CommonParameters>]Related Commands
Online VersionDetailed Description
This cmdlet retrieves SPBM-related configuration data of Virtual Machine, Hard Disk, and Datastore objects. The configuration data includes: 1. Associated storage policy for virtual machines or hard disks. 2. Compliance status for virtual machines or hard disks. 3. Associated default storage policy for datastores.Parameters
| Name | Type | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|---|
| VM | VIObject[] | Specifies the virtual machines, hard disks, and datastores for which you want to retrieve SPBM-related configuration data. | false | True (ByValue) | |
| CheckComplianceNow | SwitchParameter | If the value is $true, checks the compliance status and updates the server cache. If $false, returns the latest available compliance status from the server cache. | false | False | |
| Datastore | Datastore[] | Specifies the datastores for which you want to retrieve default storage policy data. | false | False | |
| HardDisk | HardDisk[] | Specifies virtual disks for which you want to check compliance. | false | False | |
| HardDisksOnly | SwitchParameter | If the value is $true, retrieves the configuration data only for hard disks. | false | False | |
| Server | VIServer[] | Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-VIServer cmdlet. | false | False | |
| StoragePolicy | SpbmStoragePolicy[] | Specifies the storage policies against which the compliance status will be evaluated. A storage policy can be associated with one or multiple StorageObjects (VM Home or Disks). There will be one association object with compliance status for each policy - entity combination. If no storage policy is specified, the cmdlet returns the status for all available storage policies. | false | True (ByValue) | |
| VMsOnly | SwitchParameter | If the value is $true, retrieves the configuration data only for virtual machines. | false | False |
Return Type
Zero or more objects derived from SpbmEntityConfigurationNotes
Works only with vCenter Server 5.5 or later. For more information, see the VMware Storage Policy API Reference: https://pubs.vmware.com/vsphere-60/index.jsp#com.vmware.vspsdk.apiref.doc/right-pane.htmlExamples
-------------------------- Example 1 --------------------------
Get-SpbmEntityConfiguration -StoragePolicy $policy
Returns the SPBM configuration and compliance status of all Virtual Machine and Hard Disk objects associated with the $policy storage policy.
-------------------------- Example 2 --------------------------
Get-SpbmEntityConfiguration -StoragePolicy $policy -CheckComplianceNow
Returns the SPBM configuration and compliance status of all Virtual Machine and Hard Disk objects associated with the $policy storage policy and updates the server cache.
-------------------------- Example 3 --------------------------
Get-SpbmEntityConfiguration -StoragePolicy $policy -HardDisksOnly
Returns the SPBM configuration and compliance status of all Hard Disk objects associated with the $policy storage policy.
-------------------------- Example 4 --------------------------
Get-SpbmEntityConfiguration -VM $vm1, $vm2 -CheckComplianceNow
Returns the SPBM configuration and compliance status of the $vm1 and $vm2 virtual machines and updates the server cache.
-------------------------- Example 5 --------------------------
Get-SpbmEntityConfiguration -HardDisk (Get-HardDisk -VM $vm1) -Datastore $datastore1
Returns the SPBM configuration and compliance status of all Hard Disk objects of the $vm1 virtual machine and the SPBM configuration of the $datastore1 datastore.
-------------------------- Example 6 --------------------------
Get-SpbmEntityConfiguration $vm1, $vm2, $hd1, $datastore1
Returns the SPBM configuration and compliance status of the $vm1 and $vm2 virtual machines, the $hd1 hard disk, and the SPBM configuration of the $datastore1 datastore.