New-ContentLibrary Command | Vmware PowerCLI Reference

New-ContentLibrary

This cmdlet creates a new new local or subscribed content library depending on the provided parameters.

Syntax

New-ContentLibrary
-Datastore < Datastore >
-Name < String >
[-Description < String > ]
[-OptimizeRemotePublishing ]
[-Password < String > ]
[-PersistJson ]
[-ProgressAction < ActionPreference > ]
[-Published ]
[-Server < VIServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
 Datastore Datastore named
Specifies the datastore that you want to use to store files for library items in this library.
required
 Name String named
Specifies the name of the library. Library names cannot be undefined or an empty string. Names do not have to be unique.
optional Description String named
Specifies a human-readable description for the content library that you want to create.
optional OptimizeRemotePublishing SwitchParameter named
If specified, the library is optimized for remote publishing and the Published parameter is required. This parameter specifies if remote publishing is the dominant use case for this library. The remote publishing occurs when the publisher and subscribers are not part of the same vCenter Single Sign-On domain. Any optimizations can be done as a result of turning on this optimization during library creation. For example, library content could be stored in different formats, but optimizations are not limited to just a storage format. You can set the value of this toggle only during the creation of the library and you need to migrate your library in case you need to change this value (optimize the library for a different use case).
optional Password String named
Specifies the password you want to use for the content library. If you want to create a local content library, the password is required from subscribers in Basic authentication mode. If you want to subscribe to a content library, the password should be in Basic authentication mode.
optional PersistJson SwitchParameter named
Specifies whether library and library item metadata are persisted in the storage location as JSON files. This flag only applies if the local library is published. You can copy the local library content and metadata to another storage location manually and then create a subscribed library referencing the location of the library JSON file in the SubscriptionUrl. When the subscribed library's storage location matches the subscription URL, you do not need to copy the files to the subscribed library.
optional ProgressAction ActionPreference named
optional Published SwitchParameter named
Specifies whether you need to publish the local library.
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 the Connect-VIServer cmdlet.

Output

VMware.VimAutomation.ViCore.Types.V1.ContentLibrary.ContentLibrary

Examples

Example 1 

New-ContentLibrary -Name 'Local Content Library' -Description 'Local content library description.' -Datastore $Datastore1 -Published

Creates a new local content library that uses Datastore1 as a repository for its items.

Example 2 

$localContentLibrary = Get-ContentLibrary -Name 'Local Content Library' -LocalNew-ContentLibrary -Name 'Subscribed Content Library' -Description 'Subscribed content library description.' -Datastore $Datastore1 -SubscriptionUrl $localContentLibrary.PublishUrl

Creates a new subscribed content library that is subscribed to $localContentLibrary and uses Datastore1 as a repository for its items.

Related Commands

ContentLibrary

This cmdlet creates a new local or subscribed content library.

Creates a new local or subscribed content library that uses Datastore1 as a repository for its items.

This cmdlet removes the specified content libraries.

This cmdlet modifies content library's properties.

ContentLibraryItem

This cmdlet copies content library items to a local content library.

This cmdlet exports content library item's files to the local machine.

This cmdlet retrieves catalog items from the content library.

This cmdlet creates a new content library item in the specified content library.

This cmdlet removes the specified content library items.

This cmdlet modifies content library item's properties.