New-AzureRmResourceGroup

  • リファレンス
モジュール:
AzureRM.Resources

Azure リソース グループを作成します。

重要

Az PowerShell モジュール で AzureRM PowerShell モジュールのすべての機能およびその他を利用できるようになったため、2024 年 2 月 29 日に AzureRM PowerShell モジュールは廃止になります。

サービスの中断を回避するために、2024 年 2 月 29 日までに、AzureRM PowerShell モジュールを使用するスクリプトを更新して、Az PowerShell モジュールを使用するようにしてください。 スクリプトを自動的に更新するには、 クイックスタート ガイドに従ってください。

構文

New-AzureRmResourceGroup
   -Name <String>
   -Location <String>
   [-Tag <Hashtable>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzureRmResourceGroup コマンドレットは、Azure リソース グループを作成します。 名前と場所だけを使用してリソース グループを作成し、New-AzureRmResource コマンドレットを使用してリソース グループに追加するリソースを作成できます。 既存のリソース グループにデプロイを追加するには、New-AzureRmResourceGroupDeployment コマンドレットを使用します。 既存のリソース グループにリソースを追加するには、 New-AzureRmResource コマンドレットを使用します。 Azure リソースは、データベース サーバー、データベース、Web サイトなど、ユーザーが管理する Azure エンティティです。 Azure リソース グループは、1 つのユニットとしてデプロイされる Azure リソースのコレクションです。

例

例 1: 空のリソース グループを作成する

PS> New-AzureRmResourceGroup -Name RG01 -Location "South Central US"

このコマンドは、リソースのないリソース グループを作成します。 New-AzureRmResource コマンドレットまたは New-AzureRmResourceGroupDeployment コマンドレットを使用して、このリソース グループにリソースとデプロイを追加できます。

例 2: 位置指定パラメーターを使用して空のリソース グループを作成する

PS> New-AzureRmResourceGroup RG01 "South Central US"

このコマンドは、リソースのないリソース グループを作成します。

例 3: タグを使用してリソース グループを作成する

PS> New-AzureRmResourceGroup -Name RG01 -Location "South Central US" -Tag @{Empty=$null; Department="Marketing"}

このコマンドは、空のリソース グループを作成します。 このコマンドは、リソース グループにタグを割り当てる点を除き、例 1 のコマンドと同じです。 空という名前の最初のタグを使用して、リソースがないリソース グループを識別できます。 2 番目のタグは Department という名前で、マーケティングの価値があります。 このようなタグを使用して、管理または予算作成用のリソース グループを分類できます。

パラメーター

-ApiVersion

リソース プロバイダーでサポートされている API バージョンを指定します。 既定のバージョンとは異なるバージョンを指定できます。

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

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Location

リソース グループの場所を指定します。 米国西部や東南アジアなど、Azure データ センターの場所を指定してください。 リソース グループは、任意の場所に配置できます。 リソース グループは、Azure サブスクリプションと同じ場所またはリソースと同じ場所に存在する必要はありません。 各リソースの種類をサポートする場所を特定するには、 ProviderNamespace パラメーターでGet-AzureRmResourceProvider コマンドレットを使用します。

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

リソース グループの名前を指定します。 リソース名は、サブスクリプション内で一意である必要があります。 その名前のリソース グループが既に存在する場合は、既存のリソース グループを置き換える前に確認を求められます。

Type:String
Aliases:ResourceGroupName
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Pre

このコマンドレットで、使用するバージョンが自動的に決定されるときに、プレリリース API バージョンが考慮されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Tag

ハッシュ テーブルの形式のキーと値のペア。 例: @{key0="value0";key1=$null;key2="value2"} タグを追加または変更するには、リソース グループのタグのコレクションを置き換える必要があります。 リソースとグループにタグを割り当てた後、Get-AzureRmResourceとGet-AzureRmResourceGroupの Tag パラメーターを使用して、タグ名または名前と値でリソースとグループを検索できます。 タグを使用して、部門やコスト センターなどのリソースを分類したり、リソースに関するメモやコメントを追跡したりできます。 定義済みのタグを取得するには、Get-AzureRMTag コマンドレットを使用します。

Type:Hashtable
Aliases:Tags
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

入力

None

出力

Microsoft.Azure.Commands.ResourceManagement.Models.PSResourceGroup