你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzureAffinityGroup

在当前订阅中创建地缘组。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

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

说明

New-AzureAffinityGroup cmdlet 在当前 Azure 订阅中创建 Azure 地缘组。

地缘组将服务及其资源放在 Azure 数据中心。 地缘组将成员组合在一起以实现最佳性能。 在订阅级别定义地缘组。 你的地缘组可用于你创建的任何后续云服务或存储帐户。 只有在创建服务时,才能将服务添加到地缘组。

示例

示例 1:创建地缘组

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

此命令在“美国中南部”区域创建名为“South01”的地缘组。 该命令指定标签和说明。

参数

-Description

指定地缘组的说明。 说明长度最多为 1024 个字符。

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为:

  • 继续
  • 忽略
  • 询问
  • SilentlyContinue
  • 停止
  • Suspend
类型:ActionPreference
Aliases:infa
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

指定信息变量。

类型:String
Aliases:iv
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Label

指定地缘组的标签。 标签长度可能最多为 100 个字符。

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

指定此 cmdlet 在其中创建地缘组的 Azure 数据中心的地理位置。

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定地缘组的名称。 该名称必须对订阅是唯一的。

类型:String
Position:0
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False