New-AzCosmosDBAccount
새 CosmosDB 계정을 만듭니다.
구문
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>]
Description
지정된 ResourceGroup에서 새 CosmosDB 계정을 만듭니다.
예제
예 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 : {}
이름이 databaseAccountName인 새 CosmosDB 계정이 ResourceGroup resourceGroupName에 만들어집니다.
매개 변수
-AnalyticalStorageSchemaType
분석 스토리지의 스키마 유형입니다. 유효한 값은 'WellDefined' 및 'FullFidelity'입니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ApiKind
만들 Cosmos DB 데이터베이스 계정의 유형입니다. 허용되는 값: GlobalDocumentDB, MongoDB, Gremlin, Table, Cassandra. 기본값: GlobalDocumentDB
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-AsJob
백그라운드에서 cmdlet 실행
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-BackupIntervalInMinutes
백업이 수행되는 간격(분)입니다(정기 모드 백업이 있는 계정에만 해당).
형식: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-BackupPolicyType
Cosmos DB 계정의 백업 유형입니다. 허용되는 값: 주기적, 연속
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-BackupRetentionIntervalInHours
각 백업이 보존되는 시간(시간)입니다(정기 모드 백업이 있는 계정에만 해당).
형식: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-BackupStorageRedundancy
백업 스토리지 계정의 중복 유형
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Capabilities
Cosmos DB 데이터베이스 계정에 위치를 추가합니다. 장애 조치(failover) 우선 순위에 따라 정렬되는 문자열 배열입니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ContinuousTier
Cosmos DB 계정의 연속 백업 모드 계층입니다. 허용되는 값: Continuous7Days, Continuous30Days
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DefaultConsistencyLevel
Cosmos DB 데이터베이스 계정의 기본 일관성 수준입니다. 허용되는 값: BoundedStaleness, ConsistentPrefix, Eventual, Session, Strong
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
형식: | IAzureContextContainer |
별칭: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DisableKeyBasedMetadataWriteAccess
계정 키를 통해 메타데이터 리소스(데이터베이스, 컨테이너, 처리량)에 대한 쓰기 작업 사용 안 함
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EnableAnalyticalStorage
계정에서 AnalyticalStorage를 사용할 수 있는지 여부를 나타내는 부울입니다.
형식: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EnableAutomaticFailover
가동 중단으로 인해 지역을 사용할 수 없는 드문 경우에서 쓰기 지역의 자동 장애 조치(failover)를 사용하도록 설정합니다. 자동 장애 조치(failover)로 인해 계정에 대한 새 쓰기 지역이 생성되고 계정에 대해 구성된 장애 조치(failover) 우선 순위에 따라 선택됩니다. 허용되는 값: false, true
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EnableBurstCapacity
계정에서 버스트 용량을 사용할 수 있는지 여부를 나타내는 부울입니다.
형식: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EnableFreeTier
계정에서 FreeTier를 사용할 수 있는지 여부를 나타내는 부울입니다.
형식: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EnableMultipleWriteLocations
여러 쓰기 위치를 사용하도록 설정합니다. 허용되는 값: false, true
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EnablePartitionMerge
계정에서 PartitionMerge를 사용할 수 있는지 여부를 나타내는 부울입니다. 허용되는 값: false, true
형식: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EnableVirtualNetwork
Cosmos DB 데이터베이스 계정에서 가상 네트워크를 사용하도록 설정합니다. 허용되는 값: false, true
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-FromPointInTimeBackup
새 Cosmos DB 계정 요청이 복원 요청임을 나타냅니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-IpRule
방화벽 지원. 지정된 데이터베이스 계정에 허용되는 클라이언트 IP 목록으로 포함할 CIDR 형식의 IP 주소 또는 IP 주소 범위 집합을 지정합니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-KeyVaultKeyUri
KeyVault의 URI
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Location
Cosmos DB 데이터베이스 계정에 위치를 추가합니다. 장애 조치(failover) 우선 순위에 따라 정렬되는 문자열 배열입니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-LocationObject
Cosmos DB 데이터베이스 계정에 위치를 추가합니다. PSLocation 개체의 배열입니다.
형식: | PSLocation[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-MaxStalenessIntervalInSeconds
제한된 부실 일관성과 함께 사용할 경우 이 값은 허용되는 부실(시간 범위)의 시간을 나타냅니다. 이 값에 허용되는 범위는 5-86400입니다.
형식: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-MaxStalenessPrefix
제한된 부실 일관성과 함께 사용하는 경우 이 값은 허용되는 부실 요청 수를 나타냅니다. 이 값에 허용되는 범위는 1 - 2,147,483,647입니다.
형식: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Name
Cosmos DB 데이터베이스 계정의 이름입니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-NetworkAclBypass
Synapse Link에 대해 이 계정에 대해 네트워크 Acl 바이패스를 사용할 수 있는지 여부입니다. 가능한 값은 'None', 'AzureServices'입니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-NetworkAclBypassResourceId
Synapse Link에 대한 네트워크 Acl 바이패스를 허용하는 리소스 ID 목록입니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-PublicNetworkAccess
이 서버에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 가능한 값은 'Enabled', 'Disabled'입니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ResourceGroupName
리소스 그룹의 이름입니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ServerVersion
ServerVersion, MongoDB 계정의 경우에만 유효합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Tag
키-값 쌍으로 태그의 해시 테이블입니다. 기존 태그를 지우려면 빈 문자열을 사용합니다.
형식: | Hashtable |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VirtualNetworkRule
가상 네트워크에 대한 ACL의 문자열 값 배열입니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VirtualNetworkRuleObject
가상 네트워크에 대한 PSVirtualNetworkRuleObjects의 배열입니다.
형식: | PSVirtualNetworkRule[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
None
출력
Azure PowerShell