New-AzureAffinityGroup
現在のサブスクリプションにアフィニティ グループを作成します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される 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 文字です。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- Stop
- [中断]
| 型: | ActionPreference |
| Aliases: | infa |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InformationVariable
情報変数を指定します。
| 型: | String |
| Aliases: | iv |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Label
アフィニティ グループのラベルを指定します。 ラベルの長は最大 100 文字です。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Location
このコマンドレットによってアフィニティ グループが作成される Azure データセンターの地理的な場所を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
アフィニティ グループの名前を指定します。 名前はサブスクリプションに対して一意である必要があります。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
| 型: | AzureSMProfile |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |