Freigeben über


New-AzCosmosDBAccount

Erstellen Sie ein neues CosmosDB-Konto.

Syntax

New-AzCosmosDBAccount
   [-EnableAutomaticFailover]
   [-EnableMultipleWriteLocations]
   [-EnableVirtualNetwork]
   [-FromPointInTimeBackup]
   [-ApiKind <String>]
   [-DisableKeyBasedMetadataWriteAccess]
   [-EnableFreeTier <Boolean>]
   [-Location <String[]>]
   [-LocationObject <PSLocation[]>]
   [-Capabilities <String[]>]
   -ResourceGroupName <String>
   -Name <String>
   [-DefaultConsistencyLevel <String>]
   [-IpRule <String[]>]
   [-MaxStalenessIntervalInSeconds <Int32>]
   [-MaxStalenessPrefix <Int32>]
   [-Tag <Hashtable>]
   [-VirtualNetworkRule <String[]>]
   [-VirtualNetworkRuleObject <PSVirtualNetworkRule[]>]
   [-PublicNetworkAccess <String>]
   [-KeyVaultKeyUri <String>]
   [-EnableAnalyticalStorage <Boolean>]
   [-AsJob]
   [-NetworkAclBypass <String>]
   [-NetworkAclBypassResourceId <String[]>]
   [-ServerVersion <String>]
   [-BackupIntervalInMinutes <Int32>]
   [-BackupRetentionIntervalInHours <Int32>]
   [-EnableBurstCapacity <Boolean>]
   [-BackupStorageRedundancy <String>]
   [-BackupPolicyType <String>]
   [-ContinuousTier <String>]
   [-AnalyticalStorageSchemaType <String>]
   [-EnablePartitionMerge <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Erstellen Sie ein neues CosmosDB-Konto in der angegebenen ResourceGroup.

Beispiele

Beispiel 1

New-AzCosmosDBAccount -ResourceGroupName resourceGroupName -Name databaseAccountName -Location "East US"

Kind                          : GlobalDocumentDB
ProvisioningState             : Initializing
DocumentEndpoint              :
DatabaseAccountOfferType      : Standard
IpRangeFilter                 :
IsVirtualNetworkFilterEnabled : False
EnableAutomaticFailover       : False
ConsistencyPolicy             : Microsoft.Azure.Management.CosmosDB.Models.ConsistencyPolicy
Capabilities                  : {}
WriteLocations                : {databaseAccountName-eastus}
ReadLocations                 : {databaseAccountName-eastus}
FailoverPolicies              : {databaseAccountName-eastus}
VirtualNetworkRules           : {}
EnableMultipleWriteLocations  : False
Location                      : East US
Tags                          : {}
Id                            : /subscriptions/{subscriptionid}/resourceGroups/resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/databaseAccountName
Name                          : databaseAccountName
Type                          : Microsoft.DocumentDB/databaseAccounts
NetworkAclBypass              : None
NetworkAclBypassResourceIds   : {}

Ein neues CosmosDB-Konto mit name databaseAccountName wird im ResourceGroup-Ressourcengruppenname erstellt.

Parameter

-AnalyticalStorageSchemaType

Der Schematyp für den analytischen Speicher. Gültige Werte sind: "WellDefined" und "FullFidelity".

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ApiKind

Der Typ des zu erstellenden Cosmos DB-Datenbankkontos. Akzeptierte Werte: GlobalDocumentDB, MongoDB, Gremlin, Table, Cassandra. Standardwert: GlobalDocumentDB

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AsJob

Cmdlet im Hintergrund ausführen

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BackupIntervalInMinutes

Das Intervall(in Minuten), mit dem die Sicherung ausgeführt wird (nur für Konten mit regelmäßigen Modussicherungen)

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BackupPolicyType

Die Art der Sicherungen auf dem Cosmos DB-Konto. Akzeptierte Werte: Periodisch, fortlaufend

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BackupRetentionIntervalInHours

Die Zeit(in Stunden), für die jede Sicherung aufbewahrt wird (nur für Konten mit regelmäßigen Modussicherungen)

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BackupStorageRedundancy

Der Redundanztyp des Sicherungsspeicherkontos

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Capabilities

Fügen Sie dem Cosmos DB-Datenbankkonto einen Speicherort hinzu. Array von Zeichenfolgen, sortiert nach Failoverpriorität.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ContinuousTier

Die Ebene des fortlaufenden Sicherungsmodus auf dem Cosmos DB-Konto. Akzeptierte Werte: Continuous7Days, Continuous30Days

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultConsistencyLevel

Standardkonsistenzstufe des Cosmos DB-Datenbankkontos. Akzeptierte Werte: BoundedStaleness, ConsistentPrefix, Eventual, Session, Strong

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableKeyBasedMetadataWriteAccess

Deaktivieren von Schreibvorgängen für Metadatenressourcen (Datenbanken, Container, Durchsatz) über Kontoschlüssel

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableAnalyticalStorage

Bool, um anzugeben, ob AnalyticalStorage für das Konto aktiviert ist.

Typ:Nullable<T>[Boolean]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableAutomaticFailover

Aktiviert das automatische Failover des Schreibbereichs im seltenen Fall, dass die Region aufgrund eines Ausfalls nicht verfügbar ist. Das automatische Failover führt zu einem neuen Schreibbereich für das Konto und wird basierend auf den für das Konto konfigurierten Failoverprioritäten ausgewählt. Akzeptierte Werte: false, true

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableBurstCapacity

Bool, um anzugeben, ob "Burst Capacity" für das Konto aktiviert ist.

Typ:Nullable<T>[Boolean]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableFreeTier

Bool, um anzugeben, ob FreeTier für das Konto aktiviert ist.

Typ:Nullable<T>[Boolean]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableMultipleWriteLocations

Mehrere Schreibspeicherorte aktivieren. Akzeptierte Werte: false, true

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnablePartitionMerge

Bool, um anzugeben, ob PartitionMerge für das Konto aktiviert ist. Akzeptierte Werte: false, true

Typ:Nullable<T>[Boolean]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableVirtualNetwork

Aktiviert das virtuelle Netzwerk im Cosmos DB-Datenbankkonto. Akzeptierte Werte: false, true

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FromPointInTimeBackup

Gibt an, dass die neue Cosmos DB-Kontoanforderung eine Wiederherstellungsanforderung ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IpRule

Firewallunterstützung. Gibt die Gruppe von IP-Adressen oder IP-Adressbereichen im CIDR-Formular an, die als zulässige Liste der Client-IPs für ein bestimmtes Datenbankkonto eingeschlossen werden sollen.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KeyVaultKeyUri

URI des KeyVault

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Location

Fügen Sie dem Cosmos DB-Datenbankkonto einen Speicherort hinzu. Array von Zeichenfolgen, sortiert nach Failoverpriorität.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LocationObject

Fügen Sie dem Cosmos DB-Datenbankkonto einen Speicherort hinzu. Array von PSLocation-Objekten.

Typ:PSLocation[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxStalenessIntervalInSeconds

Wenn dieser Wert mit gebundener Konsistenz verwendet wird, stellt dieser Wert den Zeitraum der Veraltetkeit (in Timepan) toleriert dar. Der zulässige Bereich für diesen Wert ist 5-86400.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxStalenessPrefix

Bei Verwendung mit gebundener Konsistenz stellt dieser Wert die Anzahl veralteter Anforderungen dar, die toleriert werden. Der zulässige Bereich für diesen Wert beträgt 1 - 2.147.483.647.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Name des Cosmos DB-Datenbankkontos.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NetworkAclBypass

Gibt an, ob die Netzwerk-Acl-Umgehung für dieses Konto für Synapse Link aktiviert ist. Mögliche Werte sind: 'None', 'AzureServices'.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NetworkAclBypassResourceId

Liste der Ressourcen-IDs, um die Netzwerk-Acl-Umgehung für Synapse-Verknüpfung zuzulassen.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicNetworkAccess

Gibt an, ob der Zugriff auf öffentliche Endpunkte für diesen Server zulässig ist. Mögliche Werte sind: "Enabled", "Disabled"

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Name der Ressourcengruppe.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServerVersion

ServerVersion, gilt nur für MongoDB-Konten.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Tag

Hashtable von Tags als Schlüsselwertpaare. Verwenden Sie leere Zeichenfolge, um vorhandene Tags zu löschen.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualNetworkRule

Array von Zeichenfolgenwerten der ACL für virtuelles Netzwerk.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualNetworkRuleObject

Array von PSVirtualNetworkRuleObjects für virtuelles Netzwerk.

Typ:PSVirtualNetworkRule[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

PSDatabaseAccountGetResults