Ldbc

0.0.1

en-US/Ldbc.dll-Help.xml

                                <?xml version="1.0" encoding="utf-8"?>

<helpItems xmlns="http://msh" schema="maml">

<command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10">

<command:details>

<command:name>Add-LiteData</command:name>

<maml:description>

<maml:para>Inserts data to the collection.</maml:para>

</maml:description>

<command:verb>Add</command:verb>

<command:noun>LiteData</command:noun>

</command:details>

<maml:description>

<maml:para>The cmdlet inserts input documents to the collection. One document may be specified as the parameter. Many documents are provided via pipeline.</maml:para>

</maml:description>

<command:syntax>

<command:syntaxItem>

<maml:name>Add-LiteData</maml:name>

<command:parameter required="true" position="0" >

<maml:name>CollectionName</maml:name>

<command:parameterValue required="true">String</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="1" >

<maml:name>InputObject</maml:name>

<command:parameterValue required="true">Object</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>AutoId</maml:name>

<command:parameterValue required="true">BsonAutoId</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Database</maml:name>

<command:parameterValue required="true">ILiteDatabase</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Result</maml:name>

</command:parameter>

</command:syntaxItem>

</command:syntax>

<command:parameters>

<command:parameter required="true" position="0" >

<maml:name>CollectionName</maml:name>

<maml:description>

<maml:para>Specifies the collection name (case insensitive).</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" pipelineInput="true (ByValue)" position="1" >

<maml:name>InputObject</maml:name>

<maml:description>

<maml:para>Input document(s).</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>AutoId</maml:name>

<maml:description>

<maml:para>Defines the automatic identifier data type.</maml:para>

<maml:para>Values : Int32, Int64, ObjectId, Guid</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Database</maml:name>

<maml:description>

<maml:para>Specifies the database. If it is omitted then the variable $Database is expected.</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Result</maml:name>

<maml:description>

<maml:para>Tells to output document _id values.</maml:para>

</maml:description>

</command:parameter>

</command:parameters>

<command:inputTypes>

<command:inputType>

<dev:type>

<maml:name>IDictionary, Ldbc.Dictionary, LiteDB.BsonDocument, PSCustomObject, ...</maml:name>

</dev:type>

<maml:description>

<maml:para>Document-like objects.</maml:para>

</maml:description>

</command:inputType>

</command:inputTypes>

<command:returnValues>

<command:returnValue>

<dev:type>

<maml:name>object</maml:name>

</dev:type>

<maml:description>

<maml:para>None or _id values.</maml:para>

</maml:description>

</command:returnValue>

</command:returnValues>

<command:examples>

<command:example>

<maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title>

<dev:code></dev:code>

</command:example>

</command:examples>

<maml:relatedLinks>

<maml:navigationLink>

</maml:navigationLink>

</maml:relatedLinks>

</command:command>

<command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10">

<command:details>

<command:name>Get-LiteData</command:name>

<maml:description>

<maml:para>Gets data from the collection.</maml:para>

</maml:description>

<command:verb>Get</command:verb>

<command:noun>LiteData</command:noun>

</command:details>

<maml:description>

<maml:para>The cmdlets gets all or specified by the filter documents from the collection.</maml:para>

</maml:description>

<command:syntax>

<command:syntaxItem>

<maml:name>Get-LiteData</maml:name>

<command:parameter required="true" position="0" >

<maml:name>CollectionName</maml:name>

<command:parameterValue required="true">String</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="1" >

<maml:name>Filter</maml:name>

<command:parameterValue required="true">String</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="2" >

<maml:name>Parameters</maml:name>

<command:parameterValue required="true">Object</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Database</maml:name>

<command:parameterValue required="true">ILiteDatabase</command:parameterValue>

</command:parameter>

</command:syntaxItem>

</command:syntax>

<command:parameters>

<command:parameter required="true" position="0" >

<maml:name>CollectionName</maml:name>

<maml:description>

<maml:para>Specifies the collection name (case insensitive).</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="1" >

<maml:name>Filter</maml:name>

<maml:description>

<maml:para>Specifies the filter expression.</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="2" >

<maml:name>Parameters</maml:name>

<maml:description>

<maml:para>Specifies the expression named parameters (IDictionary) or indexed arguments (IList or object).</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Database</maml:name>

<maml:description>

<maml:para>Specifies the database. If it is omitted then the variable $Database is expected.</maml:para>

</maml:description>

</command:parameter>

</command:parameters>

<command:returnValues>

<command:returnValue>

<dev:type>

<maml:name>Ldbc.Dictionary</maml:name>

</dev:type>

<maml:description>

<maml:para>PowerShell friendly wrapper of BsonDocument.</maml:para>

</maml:description>

</command:returnValue>

</command:returnValues>

<command:examples>

<command:example>

<maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title>

<dev:code></dev:code>

</command:example>

</command:examples>

<maml:relatedLinks>

<maml:navigationLink>

</maml:navigationLink>

</maml:relatedLinks>

</command:command>

<command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10">

<command:details>

<command:name>Remove-LiteData</command:name>

<maml:description>

<maml:para>Removes data from the collection.</maml:para>

</maml:description>

<command:verb>Remove</command:verb>

<command:noun>LiteData</command:noun>

</command:details>

<maml:description>

<maml:para>The cmdlet removes documents specified by the filter from the collection.</maml:para>

</maml:description>

<command:syntax>

<command:syntaxItem>

<maml:name>Remove-LiteData</maml:name>

<command:parameter required="true" position="0" >

<maml:name>CollectionName</maml:name>

<command:parameterValue required="true">String</command:parameterValue>

</command:parameter>

<command:parameter required="true" position="1" >

<maml:name>Filter</maml:name>

<command:parameterValue required="true">String</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="2" >

<maml:name>Parameters</maml:name>

<command:parameterValue required="true">Object</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Database</maml:name>

<command:parameterValue required="true">ILiteDatabase</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Result</maml:name>

</command:parameter>

</command:syntaxItem>

</command:syntax>

<command:parameters>

<command:parameter required="true" position="0" >

<maml:name>CollectionName</maml:name>

<maml:description>

<maml:para>Specifies the collection name (case insensitive).</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="true" position="1" >

<maml:name>Filter</maml:name>

<maml:description>

<maml:para>Specifies the filter expression.</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="2" >

<maml:name>Parameters</maml:name>

<maml:description>

<maml:para>Specifies the expression named parameters (IDictionary) or indexed arguments (IList or object).</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Database</maml:name>

<maml:description>

<maml:para>Specifies the database. If it is omitted then the variable $Database is expected.</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Result</maml:name>

<maml:description>

<maml:para>Tells to output the number of removed documents.</maml:para>

</maml:description>

</command:parameter>

</command:parameters>

<command:examples>

<command:example>

<maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title>

<dev:code></dev:code>

</command:example>

</command:examples>

<maml:relatedLinks>

<maml:navigationLink>

</maml:navigationLink>

</maml:relatedLinks>

</command:command>

<command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10">

<command:details>

<command:name>Invoke-LiteCommand</command:name>

<maml:description>

<maml:para>Invokes the LiteDB SQL command and gets results.</maml:para>

</maml:description>

<command:verb>Invoke</command:verb>

<command:noun>LiteCommand</command:noun>

</command:details>

<maml:description>

<maml:para>The cmdlet invokes the command with optional parameters (if the command supports parameters).</maml:para>

</maml:description>

<command:syntax>

<command:syntaxItem>

<maml:name>Invoke-LiteCommand</maml:name>

<command:parameter required="true" position="0" >

<maml:name>Command</maml:name>

<command:parameterValue required="true">String</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="1" >

<maml:name>Parameters</maml:name>

<command:parameterValue required="true">Object</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Database</maml:name>

<command:parameterValue required="true">ILiteDatabase</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Quiet</maml:name>

</command:parameter>

</command:syntaxItem>

</command:syntax>

<command:parameters>

<command:parameter required="true" position="0" >

<maml:name>Command</maml:name>

<maml:description>

<maml:para>Specifies the LiteDB SQL command.</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="1" >

<maml:name>Parameters</maml:name>

<maml:description>

<maml:para>Specifies the expression named parameters (IDictionary) or indexed arguments (IList or object).</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Database</maml:name>

<maml:description>

<maml:para>Specifies the database. If it is omitted then the variable $Database is expected.</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Quiet</maml:name>

<maml:description>

<maml:para>Tells not to output results.</maml:para>

</maml:description>

</command:parameter>

</command:parameters>

<command:returnValues>

<command:returnValue>

<dev:type>

<maml:name>object, Ldbc.Dictionary</maml:name>

</dev:type>

<maml:description>

<maml:para>The command result objects.</maml:para>

</maml:description>

</command:returnValue>

</command:returnValues>

<command:examples>

<command:example>

<maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title>

<dev:code></dev:code>

</command:example>

</command:examples>

<maml:relatedLinks>

<maml:navigationLink>

<maml:linkText>LiteDB SQL</maml:linkText>

<maml:uri>https://www.litedb.org/api/</maml:uri>

</maml:navigationLink>

</maml:relatedLinks>

</command:command>

<command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10">

<command:details>

<command:name>New-LiteDatabase</command:name>

<maml:description>

<maml:para>Opens new or existing database and creates the database instance.</maml:para>

</maml:description>

<command:verb>New</command:verb>

<command:noun>LiteDatabase</command:noun>

</command:details>

<maml:description>

<maml:para>The cmdlet opens new or existing database and returns the database instance for further operations. The returned instance must be closed by Dispose(). Consider using Use-LiteDatabase instead for more automatic disposal.</maml:para>

</maml:description>

<command:syntax>

<command:syntaxItem>

<maml:name>New-LiteDatabase</maml:name>

<command:parameter required="false" position="0" >

<maml:name>ConnectionString</maml:name>

<command:parameterValue required="true">ConnectionString</command:parameterValue>

</command:parameter>

</command:syntaxItem>

<command:syntaxItem>

<maml:name>New-LiteDatabase</maml:name>

<command:parameter required="false" position="0" >

<maml:name>Stream</maml:name>

<command:parameterValue required="true">Stream</command:parameterValue>

</command:parameter>

</command:syntaxItem>

</command:syntax>

<command:parameters>

<command:parameter required="false" position="0" >

<maml:name>ConnectionString</maml:name>

<maml:description>

<maml:para>Specifies the LiteDB connection string.</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="0" >

<maml:name>Stream</maml:name>

<maml:description>

<maml:para>Specifies the stream for reading and writing as the database.</maml:para>

</maml:description>

</command:parameter>

</command:parameters>

<command:returnValues>

<command:returnValue>

<dev:type>

<maml:name>LiteDB.LiteDatabase</maml:name>

</dev:type>

<maml:description>

<maml:para>The database instance. Must be disposed after use.</maml:para>

</maml:description>

</command:returnValue>

</command:returnValues>

<command:examples>

<command:example>

<maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title>

<dev:code>$Database = New-LiteDatabase &quot;MyDB.LiteDB&quot;

try {

    # working with $Database...

}

finally {

    $Database.Dispose()

}</dev:code>

<dev:remarks>

<maml:para>Classic try/finally pattern for disposing objects.</maml:para>

</dev:remarks>

</command:example>

</command:examples>

<maml:relatedLinks>

<maml:navigationLink>

<maml:linkText>Use-LiteDatabase</maml:linkText>

</maml:navigationLink>

</maml:relatedLinks>

</command:command>

<command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10">

<command:details>

<command:name>Use-LiteDatabase</command:name>

<maml:description>

<maml:para>Opens the database, invokes the script, and closes the database.</maml:para>

</maml:description>

<command:verb>Use</command:verb>

<command:noun>LiteDatabase</command:noun>

</command:details>

<maml:description>

<maml:para>The cmdlet opens new or existing database, creates the variable $Database for it, and invokes the specified script. When the script completes or fails the database is automatically disposed.</maml:para>

</maml:description>

<command:syntax>

<command:syntaxItem>

<maml:name>Use-LiteDatabase</maml:name>

<command:parameter required="false" position="0" >

<maml:name>ConnectionString</maml:name>

<command:parameterValue required="true">ConnectionString</command:parameterValue>

</command:parameter>

<command:parameter required="true" position="1" >

<maml:name>Script</maml:name>

<command:parameterValue required="true">ScriptBlock</command:parameterValue>

</command:parameter>

</command:syntaxItem>

<command:syntaxItem>

<maml:name>Use-LiteDatabase</maml:name>

<command:parameter required="false" position="0" >

<maml:name>Stream</maml:name>

<command:parameterValue required="true">Stream</command:parameterValue>

</command:parameter>

<command:parameter required="true" position="1" >

<maml:name>Script</maml:name>

<command:parameterValue required="true">ScriptBlock</command:parameterValue>

</command:parameter>

</command:syntaxItem>

</command:syntax>

<command:parameters>

<command:parameter required="false" position="0" >

<maml:name>ConnectionString</maml:name>

<maml:description>

<maml:para>Specifies the LiteDB connection string.</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="0" >

<maml:name>Stream</maml:name>

<maml:description>

<maml:para>Specifies the stream for reading and writing as the database.</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="true" position="1" >

<maml:name>Script</maml:name>

<maml:description>

<maml:para>The script operating on the database.</maml:para>

</maml:description>

</command:parameter>

</command:parameters>

<command:returnValues>

<command:returnValue>

<dev:type>

</dev:type>

<maml:description>

<maml:para>Output of the script.</maml:para>

</maml:description>

</command:returnValue>

</command:returnValues>

<command:examples>

<command:example>

<maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title>

<dev:code>Use-LiteDatabase &quot;MyDB.LiteDB&quot; {

    # working with $Database...

}</dev:code>

</command:example>

</command:examples>

<maml:relatedLinks>

<maml:navigationLink>

<maml:linkText>New-LiteDatabase</maml:linkText>

</maml:navigationLink>

</maml:relatedLinks>

</command:command>

<command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10">

<command:details>

<command:name>Use-LiteTransaction</command:name>

<maml:description>

<maml:para>Invokes the script operating on data with a transaction.</maml:para>

</maml:description>

<command:verb>Use</command:verb>

<command:noun>LiteTransaction</command:noun>

</command:details>

<maml:description>

<maml:para>The cmdlet creates a new transaction or continues using the existing in the same thread. Then it invokes the specified script. The new transaction is automatically committed or aborted depending on the script completion or failure.</maml:para>

</maml:description>

<command:syntax>

<command:syntaxItem>

<maml:name>Use-LiteTransaction</maml:name>

<command:parameter required="true" position="0" >

<maml:name>Script</maml:name>

<command:parameterValue required="true">ScriptBlock</command:parameterValue>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Database</maml:name>

<command:parameterValue required="true">ILiteDatabase</command:parameterValue>

</command:parameter>

</command:syntaxItem>

</command:syntax>

<command:parameters>

<command:parameter required="true" position="0" >

<maml:name>Script</maml:name>

<maml:description>

<maml:para>The script operating on data in the transaction.</maml:para>

</maml:description>

</command:parameter>

<command:parameter required="false" position="named" >

<maml:name>Database</maml:name>

<maml:description>

<maml:para>Specifies the database. If it is omitted then the variable $Database is expected.</maml:para>

</maml:description>

</command:parameter>

</command:parameters>

<command:returnValues>

<command:returnValue>

<dev:type>

</dev:type>

<maml:description>

<maml:para>Output of the script.</maml:para>

</maml:description>

</command:returnValue>

</command:returnValues>

<command:examples>

<command:example>

<maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title>

<dev:code>Use-LiteDatabase &quot;MyDB.LiteDB&quot; {

    Use-LiteTransaction {

        # working with $Database...

    }

}</dev:code>

</command:example>

</command:examples>

<maml:relatedLinks>

<maml:navigationLink>

</maml:navigationLink>

</maml:relatedLinks>

</command:command>

</helpItems>