你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzureRmOperationalInsightsWorkspace

创建工作区。

警告

截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 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 cmdlet 在指定的资源组和位置创建工作区。

示例

示例 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 cmdlet 获取 Operational Insights 帐户链接目标,然后将其存储在$OILinkTargets变量中。 第二个命令使用管道运算符将$OILinkTargets 中的第一个帐户链接目标传递到 New-AzureRmOperationalInsightsWorkspace cmdlet。 该命令创建一个名为 MyWorkspace 的标准 SKU 工作区,该工作区链接到$OILinkTargets中的第一个 Operational Insights 帐户。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-CustomerId

指定此工作区将链接到的帐户。 Get-AzureRmOperationalInsightsLinkTargets cmdlet 还可用于列出潜在帐户。

类型:Nullable<T>[Guid]
Position:4
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

类型:IAzureContextContainer
别名:AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Force

强制运行命令而不要求用户确认。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Location

指定要在其中创建工作区的位置,例如美国东部或西欧。

类型:String
Position:2
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

指定工作区的名称。

类型:String
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ResourceGroupName

指定 Azure 资源组的名称。 工作区在此资源组中创建。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-RetentionInDays

工作区数据保留期(以天为单位)。 730 天是所有其他 SKU 允许的最大天数

类型:Nullable<T>[Int32]
Position:6
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Sku

指定工作区的服务层。 有效值为:

  • 可用
  • standard
  • 高级
类型:String
接受的值:free, standard, premium, pernode, standalone
Position:3
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Tag

工作区的资源标记。

类型:Hashtable
Position:5
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position: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