Edit

Share via


New-AzManagedCassandraDatacenter

Create a new Azure Managed Instances for Apache Cassandra data center.

Syntax

ByNameParameterSet (Default)

New-AzManagedCassandraDatacenter
    -Location <String>
    -DelegatedSubnetId <String>
    -ResourceGroupName <String>
    -ClusterName <String>
    -DatacenterName <String>
    [-Sku <String>]
    [-DiskCapacity <Int32>]
    [-ManagedDiskCustomerKeyUri <String>]
    [-UseAvailabilityZone]
    [-NodeCount <Int32>]
    [-Base64EncodedCassandraYamlFragment <String>]
    [-BackupStorageCustomerKeyUri <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByParentObjectParameterSet

New-AzManagedCassandraDatacenter
    -Location <String>
    -DelegatedSubnetId <String>
    -ParentObject <PSClusterResource>
    [-Sku <String>]
    [-DiskCapacity <Int32>]
    [-ManagedDiskCustomerKeyUri <String>]
    [-UseAvailabilityZone]
    [-NodeCount <Int32>]
    [-Base64EncodedCassandraYamlFragment <String>]
    [-BackupStorageCustomerKeyUri <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The New-AzManagedCassandraDatacenter cmdlet creates a new managed Cassandra data center.

Examples

Example 1

New-AzManagedCassandraDatacenter `
 -ResourceGroupName "resourceGroupName" `
 -ClusterName "clusterName" `
 -DataCenterName "dataCenterName" `
 -DelegatedSubnetId "resourceId" `
 -Location "___location" `
 -NodeCount 3

Parameters

-BackupStorageCustomerKeyUri

URI to a KeyVault key used to encrypt backups of the cluster. If omitted, Azure's own keys will be used.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Base64EncodedCassandraYamlFragment

Fragment of configuration to include in cassandra.yaml on nodes of this data center, Base64 encoded.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ClusterName

Name of the managed Cassandra cluster.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ByNameParameterSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DatacenterName

Managed Cassandra Datacenter Name.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ByNameParameterSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Parameter properties

Type:IAzureContextContainer
Default value:None
Supports wildcards:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DelegatedSubnetId

The resource id of the virtual network subnet where managed Cassandra should attach network interfaces.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DiskCapacity

The number of data disks to connect to each node in the cluster.

Parameter properties

Type:

Nullable<T>[Int32]

Default value:4
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Location

The ___location to create the managed Cassandra cluster in.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ManagedDiskCustomerKeyUri

URI of a KeyVault key used to encrypt data at rest in the cluster. If omitted, Azure's own keys will be used.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-NodeCount

The number of nodes to create in this data center.

Parameter properties

Type:

Nullable<T>[Int32]

Default value:3
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ParentObject

Cassandra cluster object to create a data center in.

Parameter properties

Type:PSClusterResource
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ByParentObjectParameterSet
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-ResourceGroupName

Name of resource group.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ByNameParameterSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Sku

Name of the virtual machine sku to use for nodes in this data center. See the documentation for supported skus.

Parameter properties

Type:String
Default value:Standard_DS14_v2
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-UseAvailabilityZone

If set, allocate nodes in this data center using availability zones if they are supported in the region.

Parameter properties

Type:SwitchParameter
Default value:True
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

PSClusterResource

Outputs

PSDataCenterResource