Remove-CosmosCollection.ps1
|
function Remove-CosmosCollection { <# .SYNOPSIS Removes a Cosmos Collection .DESCRIPTION Removes a Cosmos Collection and all documents it contains .PARAMETER DatabaseName Name of the Database containing the Collection you want to remove .PARAMETER CollectionName Name of the Collection you want to remove .PARAMETER CosmosDBVariables This is the Script variable generated by Connect-CosmosDB - no need to supply this variable, unless you get really creative .EXAMPLE Remove-CosmosCollection -DatabaseName MyPrivateCosmos -CollectionName TohuVaBohu .NOTES https://docs.microsoft.com/en-us/rest/api/documentdb/delete-a-collection #> [CmdletBinding()] param ( [Parameter(Mandatory=$true, HelpMessage='Name of your database')] [string]$DatabaseName, [Parameter(Mandatory=$true, HelpMessage='Name of the Collection to remove')] [string]$CollectionName, [Parameter(Mandatory=$false, HelpMessage="Use Connect-CosmosDB to create this Variable collection")] [hashtable]$CosmosDBVariables=$Script:CosmosDBVariables ) begin { Test-CosmosDBVariable $CosmosDBVariables } process { $Collection = $CosmosDBConnection[$DatabaseName][$CollectionName] if ($Collection) { $Verb = 'DELETE' $Url = '{0}/{1}' -f $URI,$Collection._self $ResourceType = 'colls' $Header = New-CosmosDBHeader -resourceId $Collection._rid -resourceType $ResourceType -Verb $Verb try { Invoke-RestMethod -Uri $Url -Headers $Header -Method $Verb -ErrorAction Stop $Script:CosmosDBConnection.Remove($CollectionName) Write-Verbose "$CollectionName has been removed" } catch { Write-Warning -Message $_.Exception.Message } } else { Write-Warning "$CollectionName not found in $DatabaseName" } } end { } } |