Share via

New-AzureAffinityGroup

  • リファレンス
モジュール:
Azure

現在のサブスクリプションにアフィニティ グループを作成します。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。

構文

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

説明

New-AzureAffinityGroup コマンドレットは、現在の 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 文字です。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

このコマンドレットが情報イベントに応答する方法を指定します。

このパラメーターの有効値は、次のとおりです。

  • 続行
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

情報変数を指定します。

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Label

アフィニティ グループのラベルを指定します。 ラベルの長は最大 100 文字です。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

このコマンドレットによってアフィニティ グループが作成される Azure データセンターの地理的な場所を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

アフィニティ グループの名前を指定します。 名前はサブスクリプションに対して一意である必要があります。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False