PowerCLI Reference

Get-OSCustomizationSpec

Synopsis

This cmdlet retrieves the OS customization specifications available on a vCenter Server system.

Syntax

Get-OSCustomizationSpec [[-Server] <VIServer[]>] [[-Name] <String[]>] [-Id <String[]>] [-Type <OSCustomizationSpecType>] [<CommonParameters>]

Related Commands

Online version
New-OSCustomizationSpec
Remove-OSCustomizationSpec
Set-OSCustomizationSpec

Detailed Description

This cmdlet retrieves the OS customization specifications available on a vCenter Server system. To specify a server different from the default one, use the Server parameter.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
NameString[]Specifies the names of the OS customization specifications you want to retrieve.falsefalse
ServerVIServer[]Specifies the vCenter Server systems on which you want to run the cmdlet. If no 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.falsefalse
IdString[]Specifies the IDs of the OS customization specifications 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.
falsefalse
TypeOSCustomizationSpecTypeSpecifis the type of the OS customization specifications you want to retrieve. The valid values are Persistent and NonPersistent.falsefalse

Return Type

Zero or more OSCustomizationSpec objects

Notes

Examples

-------------- Example 1 --------------

Get-OSCustomizationSpec "test"

Retrieves from the server the OS customization specification named 'test'.

-------------- Example 2 --------------

New-VM -Name VM -VMHost Host -Template Template -OSCustomizationSpec $spec

Creates a new virtual machine from a template and configures it using a customization specification.


Copyright © VMware, Inc. All rights reserved.