New-AzureAffinityGroup
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]
New-AzureAffinityGroup
Creates a new affinity group for the current Windows Azure subscription.
Parameter Set: Default
New-AzureAffinityGroup [-Name] <String> -Location <String> [-Description <String> ] [-Label <String> ] [ <CommonParameters>]
This topic describes the cmdlet in the .6.19 version of the Windows Azure PowerShell module. To find out the version of the module you're using, from the Windows Azure PowerShell console, type (get-module azure).version.
The New-AzureAffinityGroup cmdlet creates a new affinity group in the current subscription. An affinity group places your services and their resources together in a Windows Azure data center. The affinity group members are grouped together for optimal performance.
Affinity groups are defined at the subscription level and are available to any subsequent cloud services or storage accounts that you create. Services can be added to an affinity group only at the time of creation of the service.
-Description<String>
Specifies a description for the affinity group. The description may be up to 1024 characters in length.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Label<String>
Specifies a label for the affinity group. The label may be up to 100 characters in length.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
The same one as the Name |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Location<String>
Required. The Location parameter specifies the geographical location of the data center where the affinity group will be created.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies a name for the new affinity group that is unique to the subscription.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
-------------- Example 1 --------------
This command creates a new affinity group named "South1" in the "South Central US" region and specifies both a label and a description.
C:\PS>New-AzureAffinityGroup -Name South1 -Location "South Central US" -Label "South Region" -Description "Affinity group for production applications in southern region."