Skip to content

Get CosmosDbUser

Daniel Scott-Raynsford edited this page Mar 9, 2018 · 4 revisions

external help file: CosmosDB-help.xml Module Name: CosmosDB online version: schema: 2.0.0

Get-CosmosDbUser

SYNOPSIS

Return the users in a CosmosDB database.

SYNTAX

Context (Default)

Get-CosmosDbUser -Context <Context> [-Database <String>] [-Key <SecureString>] [-Id <String>]
 [<CommonParameters>]

Account

Get-CosmosDbUser -Account <String> [-Database <String>] [-Key <SecureString>] [-KeyType <String>]
 [-Id <String>] [<CommonParameters>]

DESCRIPTION

This cmdlet will return the users in a CosmosDB database. If the Id is specified then only the user matching this Id will be returned, otherwise all users will be returned.

EXAMPLES

Example 1

PS C:\> Get-CosmosDbUser -Context $cosmosDbContext

Get a list of users from the database.

Example 2

PS C:\> Get-CosmosDbUser -Context $cosmosDbContext -Id 'Mary'

Get a the user with Id 'Mary' from the database.

PARAMETERS

-Context

This is an object containing the context information of the CosmosDB database that will be deleted. It should be created by `New-CosmosDbContext`.

Type: Context
Parameter Sets: Context
Aliases: Connection

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Account

The account name of the CosmosDB to access.

Type: String
Parameter Sets: Account
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Database

The name of the database to access in the CosmosDB account.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Key

The key to be used to access this CosmosDB.

Type: SecureString
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-KeyType

The type of key that will be used to access ths CosmosDB.

Type: String
Parameter Sets: Account
Aliases:

Required: False
Position: Named
Default value: Master
Accept pipeline input: False
Accept wildcard characters: False

-Id

This is the id of the collection to get. If not specified all collections in the database will be returned.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

System.Object

NOTES

RELATED LINKS

CosmosDB Cmdlets

Clone this wiki locally