New-AzureAffinityGroup

NAME New-AzureAffinityGroup



SYNOPSIS

Creates an affinity group in the current subscription.





SYNTAX

New-AzureAffinityGroup [-Name] <String> [-Label <String>] [-Description <String>] -Location <String> [-Profile <AzureSMProfile>] [-InformationAction

<ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]





DESCRIPTION

The New-AzureAffinityGroup cmdlet creates an Azure affinity group in the current Azure subscription.



An affinity group puts your services and their resources together in an Azure datacenter. The affinity group groups members together for optimal

performance. Define affinity groups at the subscription level. Your affinity groups are available to any subsequent cloud services or storage accounts

that you create. You can add services to an affinity group only when you create it.





PARAMETERS

-Name <String>

Specifies a name for the affinity group. The name must be unique to the subscription.



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Label <String>

Specifies a label for the affinity group. The label may be up to 100 characters long.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Description <String>

Specifies a description for the affinity group. The description may be up to 1024 characters long.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Location <String>

Specifies the geographical location of the Azure datacenter where this cmdlet creates the affinity group.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Profile <AzureSMProfile>

Specifies the Azure profile from which this cmdlet reads. If you do not specify a profile, this cmdlet reads from the local default profile.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-InformationAction <ActionPreference>





Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-InformationVariable <String>





Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



NOTES









-------------------------- Example 1: Create an affinity group --------------------------



PS C:\\>New-AzureAffinityGroup -Name "South01" -Location "South Central US" -Label "South Region" -Description "Affinity group for production

applications in southern region."



This command creates an affinity group named South01 in the South Central US region. The command specifies a label and a description.



RELATED LINKS

Get-AzureAffinityGroup

Remove-AzureAffinityGroup

Set-AzureAffinityGroup