New-AzResourceGroup
構文
Default (既定)
New-AzResourceGroup
[-Name] <String>
[-Location] <String>
[-Tag <Hashtable>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
New-AzResourceGroup コマンドレットは、Azure リソース グループを作成します。
名前と場所のみを使用してリソース グループを作成し、New-AzResource コマンドレットを使用してリソース グループに追加するリソースを作成できます。
既存のリソース グループにデプロイを追加するには、New-AzResourceGroupDeployment コマンドレットを使用します。 既存のリソース グループにリソースを追加するには、New-AzResource コマンドレットを使用します。 Azure リソースは、データベース サーバー、データベース、Web サイトなど、ユーザーが管理する Azure エンティティです。 Azure リソース グループは、ユニットとしてデプロイされる Azure リソースのコレクションです。
例
例 1: 空のリソース グループを作成する
New-AzResourceGroup -Name RG01 -Location "South Central US"
このコマンドは、リソースのないリソース グループを作成します。 New-AzResource または New-AzResourceGroupDeployment コマンドレットを して、リソースとデプロイをこのリソース グループに追加できます。
例 2: 位置指定パラメーターを使用して空のリソース グループを作成する
New-AzResourceGroup RG01 "South Central US"
このコマンドは、リソースのないリソース グループを作成します。
例 3: タグを使用してリソース グループを作成する
New-AzResourceGroup -Name RG01 -Location "South Central US" -Tag @{Empty=$null; Department="Marketing"}
このコマンドを実行すると、空のリソース グループが作成されます。 このコマンドは、リソース グループにタグを割り当てる点を除き、例 1 のコマンドと同じです。 Empty という名前の最初のタグを使用して、リソースのないリソース グループを識別できます。 2 番目のタグは Department という名前で、マーケティングの値を持っています。 このようなタグを使用して、管理または予算作成用のリソース グループを分類できます。
パラメーター
-ApiVersion
リソース プロバイダーでサポートされている API バージョンを指定します。
既定のバージョンとは異なるバージョンを指定できます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
パラメーターのプロパティ
| 型: | IAzureContextContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Location
リソース グループの場所を指定します。 米国西部や東南アジアなどの Azure データ センターの場所を指定します。 リソース グループは、任意の場所に配置できます。 リソース グループは、Azure サブスクリプションと同じ場所、またはそのリソースと同じ場所に存在する必要はありません。
各リソースの種類をサポートする場所を特定するには、ProviderNamespace パラメーターと共に Get-AzResourceProvider コマンドレットを使用します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Name
リソース グループの名前を指定します。 リソース名は、サブスクリプション内で一意である必要があります。 その名前のリソース グループが既に存在する場合は、既存のリソース グループを置き換える前に確認を求められます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | リソースグループ名 |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Pre
このコマンドレットは、使用するバージョンを自動的に決定するときに、プレリリース API バージョンを考慮することを示します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Tag
ハッシュ テーブルの形式のキーと値のペア。 例: @{key0="value0";key1=$null;key2="value2"} タグを追加または変更するには、リソース グループのタグのコレクションを置き換える必要があります。
リソースとグループにタグを割り当てた後は、Get-AzResource と Get-AzResourceGroup の Tag パラメーターを使用して、タグ名または名前と値でリソースとグループを検索できます。 タグを使用して、部門やコスト センターなどのリソースを分類したり、リソースに関するメモやコメントを追跡したりできます。
定義済みのタグを取得するには、Get-AzTag コマンドレットを使用します。
パラメーターのプロパティ
| 型: | Hashtable
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | タグ |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力
