次の方法で共有

New-AzureRmOperationalInsightsWorkspace

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

ワークスペースを作成します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

New-AzureRmOperationalInsightsWorkspace
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Location] <String>
   [[-Sku] <String>]
   [[-CustomerId] <Guid>]
   [[-Tag] <Hashtable>]
   [[-RetentionInDays] <Int32>]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzureRmOperationalInsightsWorkspace コマンドレットは、指定したリソース グループと場所にワークスペースを作成します。

例

例 1: 名前でワークスペースを作成する

PS C:\>New-AzureRmOperationalInsightsWorkspace -ResourceGroupName "ContosoResourceGroup" -Name "MyWorkspace" -Location "East US" -Sku "Standard"

このコマンドは、ContosoResourceGroup という名前のリソース グループに MyWorkspace という名前の標準 SKU ワークスペースを作成します。

例 2: ワークスペースを作成し、既存のアカウントにリンクする

PS C:\>$OILinkTargets = Get-AzureRmOperationalInsightsLinkTargets

PS C:\>$OILinkTargets[0] | New-AzureRmOperationalInsightsWorkspace -ResourceGroupName "ContosoResourceGroup" -Name "MyWorkspace" -Sku "Standard"

最初のコマンドでは、Get-AzureRmOperationalInsightsLinkTargets コマンドレットを使用して Operational Insights アカウントのリンク ターゲットを取得し、$OILinkTargets変数に格納します。 2 番目のコマンドは、パイプライン 演算子を使用して、$OILinkTargetsの最初のアカウント リンク ターゲットを New-AzureRmOperationalInsightsWorkspace コマンドレットに渡します。 このコマンドにより、MyWorkspace という名前の標準 SKU ワークスペースが作成され、$OILinkTargetsの最初の Operational Insights アカウントにリンクされます。

パラメーター

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CustomerId

このワークスペースのリンク先となるアカウントを指定します。 Get-AzureRmOperationalInsightsLinkTargets コマンドレットを使用して、潜在的なアカウントを一覧表示することもできます。

型:Nullable<T>[Guid]
配置:4
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Location

ワークスペースを作成する場所 (米国東部や西ヨーロッパなど) を指定します。

型:String
配置:2
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

ワークスペースの名前を指定します。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ResourceGroupName

Azure リソース グループの名前を指定します。 ワークスペースはこのリソース グループに作成されます。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-RetentionInDays

ワークスペースのデータ保有期間 (日数)。 730 日は、他のすべての SKU で許可される最大値です

型:Nullable<T>[Int32]
配置:6
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Sku

ワークスペースのサービス レベルを指定します。 有効な値は次の通りです。

  • 制限なし
  • standard
  • Premium
型:String
指定可能な値:free, standard, premium, pernode, standalone
配置:3
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Tag

ワークスペースのリソース タグ。

型:Hashtable
配置:5
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

Nullable<T>[[System.Guid, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Hashtable

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

出力

PSWorkspace