New-CosmosDocument.ps1

function New-CosmosDocument {
    <#
    .SYNOPSIS
    Creates a new Cosmos Document
    
    .DESCRIPTION
    Creates a new Cosmos Document in the Collection you specify
    
    .PARAMETER DatabaseName
    Name of the Database containing the Collection where the document should be created
    
    .PARAMETER CollectionName
    Name of the Collection where the Document should be created
    
    .PARAMETER Document
    A hashtable containing your document. Remember the id key. The cmdlet converts the hashtable to json
    
    .PARAMETER CosmosDBVariables
    This is the Script variable generated by Connect-CosmosDB - no need to supply this variable, unless you get really creative
    
    .EXAMPLE
    $Document = @{
            id='91387b17-2f3b-4a2d-bb6f-d4b9362990f0'
            GivenName='Utter'
            Surname='Despair'}

    New-CosmosDocument -DatabaseName MyPrivateCosmos -CollectionName Chaos -Document $Document

    
    .NOTES
    https://docs.microsoft.com/en-us/rest/api/documentdb/create-a-document
    #>
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$true,
        HelpMessage='Name of the Database containing the Collection')]
        [string]$DatabaseName,
        [Parameter(Mandatory=$true,
        HelpMessage='Name of the Collection where the Document should be created')]
        [string]$CollectionName,
        [Parameter(Mandatory=$true,
        HelpMessage='The document formatted as a hashtable')]
        [hashtable]$Document,
        [Parameter(Mandatory=$false,
        HelpMessage="Use Connect-CosmosDB to create this Variable collection")]
        [hashtable]$CosmosDBVariables=$Script:CosmosDBVariables
    )
    
    begin {
        Test-CosmosDBVariable $CosmosDBVariables
        $Database = $CosmosDBConnection[($DatabaseName + '_db')]
        if (-not $Database) {
            Write-Warning "$DatabaseName not found"
            continue
        }
        $Collection = $CosmosDBConnection[$DatabaseName][$CollectionName]
        if (-not $Collection) {
            Write-Warning "Collection $CollectionName Database $DatabaseName not found"
            continue
        }
        if (!$Document['id']){
            Write-Warning "There is no id value in the document"
            continue
        }
    }
    
    process {
        $Verb = 'POST'
        $Url = '{0}/{1}docs' -f $CosmosDBVariables['URI'],$Collection._self
        $ResourceType = 'docs'
        $Header = New-CosmosDBHeader -resourceId $Collection._rid -resourceType $ResourceType -Verb $Verb
        $Header['x-ms-documentdb-is-upsert'] = 'true'
        $CosmosBody = $Document | ConvertTo-Json
        Write-Verbose $CosmosBody
        try {
            $Return = Invoke-RestMethod -Uri $Url -Headers $Header -Method $Verb -Body $CosmosBody -ErrorAction Stop
            Write-Verbose "$($Document['id']) has been created in $CollectionName"
        }
        catch {
            Write-Warning -Message $_.Exception.Message
        }
    }
    
    end {
    }
}