text: ---
  external help file:
  Module Name: Az.MariaDb
  online version: https://docs.microsoft.com/en-us/powershell/module/az.mariadb/new-azmariadbreplica
  schema: 2.0.0
  ---
  
  # New-AzMariaDbReplica
  
  ## SYNOPSIS
  Creates a replica of a MariaDB server.
  
  ## SYNTAX
  
  ### ServerName (Default)
  ```
  New-AzMariaDbReplica -MasterName <String> -ReplicaName <String> -ResourceGroupName <String>
   [-SubscriptionId <String>] [-Location <String>] [-Sku <String>] [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>] [-AsJob] [-NoWait] [-Confirm] [-WhatIf] [<CommonParameters>]
  ```
  
  ### ServerObject
  ```
  New-AzMariaDbReplica -Master <IServer> -ReplicaName <String> [-SubscriptionId <String>] [-Location <String>]
   [-Sku <String>] [-Tag <Hashtable>] [-DefaultProfile <PSObject>] [-AsJob] [-NoWait] [-Confirm] [-WhatIf]
   [<CommonParameters>]
  ```
  
  ## DESCRIPTION
  Creates a replica of a MariaDB server.
  
  ## EXAMPLES
  
  ### Example 1: Create a replica db for a MariaDB
  ```powershell
  PS C:\> New-AzMariaDbReplica -MasterName mariadb-test-9pebvn -ReplicaName mariadb-test-9pebvn-rep01 -ResourceGroupName mariadb-test-qu5ov0
  
  Name                      Location AdministratorLogin Version StorageProfileStorageMb SkuName   SkuTier        SslEnforcement
  ----                      -------- ------------------ ------- ----------------------- -------   -------        --------------
  mariadb-test-9pebvn-rep01 eastus   xpwjyfdgui         10.2    7168                    GP_Gen5_4 GeneralPurpose Enabled
  ```
  
  This command creates a replica db for a MariaDB.
  
  ### Example 2: Create a replica db for a MariaDB
  ```powershell
  PS C:\> Get-AzMariaDbServer -Name mariadb-test-9pebvn -ResourceGroupName mariadb-test-qu5ov0 | New-AzMariaDbReplica -ReplicaName mariadb-test-9pebvn-rep02
  
  Name                      Location AdministratorLogin Version StorageProfileStorageMb SkuName   SkuTier        SslEnforcement
  ----                      -------- ------------------ ------- ----------------------- -------   -------        --------------
  mariadb-test-9pebvn-rep02 eastus   xpwjyfdgui         10.2    7168                    GP_Gen5_4 GeneralPurpose Enabled
  ```
  
  This command creates a replica db for a MariaDB.
  
  ### Example 3: Create a replica db for a MariaDB
  ```powershell
  PS C:\> $mariaDb = Get-AzMariaDbServer -Name mariadb-test-9pebvn -ResourceGroupName mariadb-test-qu5ov0 
  PS C:\> New-AzMariaDbReplica -Master $mariaDb -ReplicaName mariadb-test-9pebvn-rep03
  
  Name                      Location AdministratorLogin Version StorageProfileStorageMb SkuName   SkuTier        SslEnforcement
  ----                      -------- ------------------ ------- ----------------------- -------   -------        --------------
  mariadb-test-9pebvn-rep03 eastus   xpwjyfdgui         10.2    7168                    GP_Gen5_4 GeneralPurpose Enabled
  ```
  
  This command with parameter inputobject creates a replica db with parameter inputobject for a MariaDB.
  
  ## PARAMETERS
  
  ### -AsJob
  Run the command as a job
  
  ```yaml
  Type: System.Management.Automation.SwitchParameter
  Parameter Sets: (All)
  Aliases:
  
  Required: False
  Position: Named
  Default value: None
  Accept pipeline input: False
  Accept wildcard characters: False
  ```
  
  ### -DefaultProfile
  region DefaultParameters
   The credentials, account, tenant, and subscription used for communication with Azure.
  
  ```yaml
  Type: System.Management.Automation.PSObject
  Parameter Sets: (All)
  Aliases: AzureRMContext, AzureCredential
  
  Required: False
  Position: Named
  Default value: None
  Accept pipeline input: False
  Accept wildcard characters: False
  ```
  
  ### -Location
  The location the resource resides in.
  
  ```yaml
  Type: System.String
  Parameter Sets: (All)
  Aliases:
  
  Required: False
  Position: Named
  Default value: None
  Accept pipeline input: False
  Accept wildcard characters: False
  ```
  
  ### -Master
  The source server object to restore from.
  To construct, see NOTES section for MASTER properties and create a hash table.
  
  ```yaml
  Type: Microsoft.Azure.PowerShell.Cmdlets.MariaDb.Models.Api20180601Preview.IServer
  Parameter Sets: ServerObject
  Aliases: InputObject
  
  Required: True
  Position: Named
  Default value: None
  Accept pipeline input: True (ByValue)
  Accept wildcard characters: False
  ```
  
  ### -MasterName
  MariaDB server name.
  
  ```yaml
  Type: System.String
  Parameter Sets: ServerName
  Aliases: ServerName
  
  Required: True
  Position: Named
  Default value: None
  Accept pipeline input: False
  Accept wildcard characters: False
  ```
  
  ### -NoWait
  Run the command asynchronously
  
  ```yaml
  Type: System.Management.Automation.SwitchParameter
  Parameter Sets: (All)
  Aliases:
  
  Required: False
  Position: Named
  Default value: None
  Accept pipeline input: False
  Accept wildcard characters: False
  ```
  
  ### -ReplicaName
  Replica name.
  
  ```yaml
  Type: System.String
  Parameter Sets: (All)
  Aliases: ReplicaServerName, Name
  
  Required: True
  Position: Named
  Default value: None
  Accept pipeline input: False
  Accept wildcard characters: False
  ```
  
  ### -ResourceGroupName
  You can obtain this value from the Azure Resource Manager API or the portal.
  
  ```yaml
  Type: System.String
  Parameter Sets: ServerName
  Aliases:
  
  Required: True
  Position: Named
  Default value: None
  Accept pipeline input: False
  Accept wildcard characters: False
  ```
  
  ### -Sku
  The name of the sku, typically, tier + family + cores, e.g.
  B_Gen4_1, GP_Gen5_8.
  
  ```yaml
  Type: System.String
  Parameter Sets: (All)
  Aliases:
  
  Required: False
  Position: Named
  Default value: None
  Accept pipeline input: False
  Accept wildcard characters: False
  ```
  
  ### -SubscriptionId
  The subscription ID is part of the URI for every service call.
  
  ```yaml
  Type: System.String
  Parameter Sets: (All)
  Aliases:
  
  Required: False
  Position: Named
  Default value: (Get-AzContext).Subscription.Id
  Accept pipeline input: False
  Accept wildcard characters: False
  ```
  
  ### -Tag
  Application-specific metadata in the form of key-value pairs.
  
  ```yaml
  Type: System.Collections.Hashtable
  Parameter Sets: (All)
  Aliases:
  
  Required: False
  Position: Named
  Default value: None
  Accept pipeline input: False
  Accept wildcard characters: False
  ```
  
  ### -Confirm
  Prompts you for confirmation before running the cmdlet.
  
  ```yaml
  Type: System.Management.Automation.SwitchParameter
  Parameter Sets: (All)
  Aliases: cf
  
  Required: False
  Position: Named
  Default value: None
  Accept pipeline input: False
  Accept wildcard characters: False
  ```
  
  ### -WhatIf
  Shows what would happen if the cmdlet runs.
  The cmdlet is not run.
  
  ```yaml
  Type: System.Management.Automation.SwitchParameter
  Parameter Sets: (All)
  Aliases: wi
  
  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
  
  ### Microsoft.Azure.PowerShell.Cmdlets.MariaDb.Models.Api20180601Preview.IServer
  
  ## OUTPUTS
  
  ### Microsoft.Azure.PowerShell.Cmdlets.MariaDb.Models.Api20180601Preview.IServer
  
  ## NOTES
  
  ALIASES
  
  COMPLEX PARAMETER PROPERTIES
  
  To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.
  
  
  MASTER <IServer>: The source server object to restore from.
    - `Location <String>`: The location the resource resides in.
    - `[Tag <ITrackedResourceTags>]`: Application-specific metadata in the form of key-value pairs.
      - `[(Any) <String>]`: This indicates any property can be added to this object.
    - `[AdministratorLogin <String>]`: The administrator's login name of a server. Can only be specified when the server is being created (and is required for creation).
    - `[EarliestRestoreDate <DateTime?>]`: Earliest restore point creation time (ISO8601 format)
    - `[FullyQualifiedDomainName <String>]`: The fully qualified domain name of a server.
    - `[IdentityType <IdentityType?>]`: The identity type. Set this to 'SystemAssigned' in order to automatically create and assign an Azure Active Directory principal for the resource.
    - `[MasterServerId <String>]`: The master server id of a replica server.
    - `[ReplicaCapacity <Int32?>]`: The maximum number of replicas that a master server can have.
    - `[ReplicationRole <String>]`: The replication role of the server.
    - `[SkuCapacity <Int32?>]`: The scale up/out capacity, representing server's compute units.
    - `[SkuFamily <String>]`: The family of hardware.
    - `[SkuName <String>]`: The name of the sku, typically, tier + family + cores, e.g. B_Gen4_1, GP_Gen5_8.
    - `[SkuSize <String>]`: The size code, to be interpreted by resource as appropriate.
    - `[SkuTier <SkuTier?>]`: The tier of the particular SKU, e.g. Basic.
    - `[SslEnforcement <SslEnforcementEnum?>]`: Enable ssl enforcement or not when connect to server.
    - `[StorageProfileBackupRetentionDay <Int32?>]`: Backup retention days for the server.
    - `[StorageProfileGeoRedundantBackup <GeoRedundantBackup?>]`: Enable Geo-redundant or not for server backup.
    - `[StorageProfileStorageAutogrow <StorageAutogrow?>]`: Enable Storage Auto Grow.
    - `[StorageProfileStorageMb <Int32?>]`: Max storage allowed for a server.
    - `[UserVisibleState <ServerState?>]`: A state of a server that is visible to user.
    - `[Version <ServerVersion?>]`: Server version.
  
  ## RELATED LINKS
  
  