New-ContentLibrary

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

Syntax

-Datastore  <Datastore>
-Name  <String>
[-Description  <String>]
[-OptimizeRemotePublishing]
[-Password  <String>]
[-PersistJson]
[-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.
optional
Password
String named Specifies the password you want to use for the content library.
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.
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.

-Datastore  <Datastore>
-Name  <String>
-SubscriptionUrl  <String>
[-AutomaticSync]
[-Description  <String>]
[-DownloadContentOnDemand]
[-Password  <String>]
[-Server  <VIServer[]>]
[-SslThumbprint  <String>]
[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.
required
SubscriptionUrl
String named Specifies the URL of the endpoint where the metadata for the remotely published library is served.
optional
AutomaticSync
SwitchParameter named Specifies whether the library should participate in automatic library synchronization. If you want to do an automatic synchronization, the global Automatic Sync option must be enabled.
optional
Description
String named Specifies a human-readable description for the content library that you want to create.
optional
DownloadContentOnDemand
SwitchParameter named Indicates whether a library item's content is synchronized only on demand.
optional
Password
String named Specifies the password you want to use for the content 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.
optional
SslThumbprint
String named Specifies an optional SHA-1 hash of the SSL certificate for the remote endpoint.

Output

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

Examples


Example 1

PS C:\> 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

PS C:\> $localContentLibrary = Get-ContentLibrary -Name 'Local Content Library' -Local
PS C:\> New-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

Feedback

Was this page helpful?