Move-AzResource

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

リソースを別のリソース グループまたはサブスクリプションに移動します。

構文

Move-AzResource
    -DestinationResourceGroupName <String>
    [-DestinationSubscriptionId <Guid>]
    -ResourceId <String[]>
    [-Force]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Move-AzResource コマンドレットは、既存のリソースを別のリソース グループに移動します。 そのリソース グループは、別のサブスクリプションに存在できます。

例

例 1: リソースをリソース グループに移動する

$Resource = Get-AzResource -ResourceType "Microsoft.ClassicCompute/storageAccounts" -ResourceName "ContosoStorageAccount"
Move-AzResource -ResourceId $Resource.ResourceId -DestinationResourceGroupName "ResourceGroup14"

最初のコマンドは、Get-AzResource コマンドレットを使用して ContosoStorageAccount という名前のリソースを取得し、そのリソースを$Resource変数に格納します。 2 番目のコマンドは、そのリソースを ResourceGroup14 という名前のリソース グループに移動します。 このコマンドは、$Resourceの ResourceId プロパティを使用して移動するリソースを識別します。

パラメーター

-ApiVersion

使用するリソース プロバイダー API のバージョンを指定します。 バージョンを指定しない場合、このコマンドレットは使用可能な最新バージョンを使用します。

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

-Confirm

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

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

-DefaultProfile

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

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

-DestinationResourceGroupName

このコマンドレットがリソースを移動するリソース グループの名前を指定します。

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

-DestinationSubscriptionId

このコマンドレットがリソースを移動するサブスクリプションの ID を指定します。

Type:Nullable<T>[Guid]
Aliases:Id, SubscriptionId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

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

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

-Pre

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

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

-ResourceId

このコマンドレットが移動するリソースの ID の配列を指定します。

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

-WhatIf

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

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

入力

Nullable<T>[[System.Guid, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

String[]

出力

Boolean