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

New-AzMLWorkspace

使用指定的参数创建或更新工作区。

语法

New-AzMLWorkspace
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-AllowPublicAccessWhenBehindVnet]
   [-ApplicationInsightId <String>]
   [-ContainerRegistryId <String>]
   [-CosmoDbCollectionsThroughput <Int32>]
   [-Description <String>]
   [-DiscoveryUrl <String>]
   [-EncryptionStatus <EncryptionStatus>]
   [-EncryptionUserAssignedIdentity <String>]
   [-FriendlyName <String>]
   [-HbiWorkspace]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssigned <Hashtable>]
   [-ImageBuildCompute <String>]
   [-KeyVaultArmId <String>]
   [-KeyVaultId <String>]
   [-KeyVaultIdentityClientId <String>]
   [-KeyVaultKeyIdentifier <String>]
   [-Location <String>]
   [-PrimaryUserAssignedIdentity <String>]
   [-PublicNetworkAccess <PublicNetworkAccess>]
   [-SharedPrivateLinkResource <ISharedPrivateLinkResource[]>]
   [-SkuCapacity <Int32>]
   [-SkuFamily <String>]
   [-SkuName <String>]
   [-SkuSize <String>]
   [-SkuTier <SkuTier>]
   [-StorageAccountId <String>]
   [-Tag <Hashtable>]
   [-V1LegacyMode]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

说明

使用指定的参数创建或更新工作区。

示例

示例 1:使用指定的参数创建或更新工作区

New-AzMLWorkspace -ResourceGroupName ml-rg-test -Name mlworkspace-pwsh01 -Location eastus -ApplicationInsightId "/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourcegroups/ml-rg-test/providers/microsoft.insights/components/insightsmlworkspace" -KeyVaultId "/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourcegroups/ml-rg-test/providers/microsoft.keyvault/vaults/kmlworkspace" -StorageAccountId "/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourcegroups/ml-rg-test/providers/microsoft.storage/storageaccounts/storagemlworkspace01" -IdentityType 'SystemAssigned'

Name              SystemDataCreatedAt  SystemDataCreatedBy  SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy SystemDataLastModifiedByType Location ResourceGroupName
----              -------------------  -------------------  ----------------------- ------------------------ ------------------------ ---------------------------- -------- -----------------
mlworkspace-pwsh01 5/18/2022 6:33:49 AM v-diya@microsoft.com User                    5/18/2022 6:33:49 AM     v-diya@microsoft.com     User                         eastus   ml-rg-test

使用指定的参数创建或更新工作区

参数

-AllowPublicAccessWhenBehindVnet

指示在 VNet 后面是否允许公共访问的标志。

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

-ApplicationInsightId

与此工作区关联的 application Insights 的 ARM ID。

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

-AsJob

以作业身份运行命令

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

-Confirm

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

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

-ContainerRegistryId

与此工作区关联的容器注册表的 ARM ID。

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

-CosmoDbCollectionsThroughput

cosmosdb 数据库中集合的吞吐量

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

-DefaultProfile

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

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

此工作区的说明。

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

-DiscoveryUrl

用于标识机器学习试验服务的区域终结点的发现服务的 URL

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

-EncryptionStatus

指示是否为工作区启用加密。

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

-EncryptionUserAssignedIdentity

将用于访问客户管理的密钥保管库的用户分配标识的 ArmId

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

-FriendlyName

此工作区的友好名称。 此名称在可变中

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

-HbiWorkspace

用于向工作区中的 HBI 数据发出信号并减少服务收集的诊断数据的标志

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

-IdentityType

托管服务标识的类型(其中允许 SystemAssigned 和 UserAssigned 类型)。

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

-IdentityUserAssigned

与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将为 ARM 资源 ID,格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 字典值可以是请求中的空对象({})。

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

-ImageBuildCompute

映像生成的计算名称

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

-KeyVaultArmId

客户拥有加密密钥的 keyVault 的 ArmId。

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

-KeyVaultId

与此工作区关联的密钥保管库的 ARM ID。 创建工作区后,无法更改此更改

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

-KeyVaultIdentityClientId

将来使用 - 将用于访问密钥保管库的标识的客户端 ID。

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

-KeyVaultKeyIdentifier

用于访问加密密钥的密钥保管库 URI。

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

-Location

指定资源的位置。

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

-Name

Azure 机器学习工作区的名称。

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

-NoWait

异步运行命令

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

-PrimaryUserAssignedIdentity

表示工作区标识的用户分配的标识资源 ID。

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

-PublicNetworkAccess

是否允许来自公用网络的请求。

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

-ResourceGroupName

资源组的名称。 此名称不区分大小写。

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

-SharedPrivateLinkResource

此工作区中共享的专用链接资源列表。 若要构造,请参阅 SHAREDPRIVATELINKRESOURCE 属性的 NOTES 部分并创建哈希表。

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

-SkuCapacity

如果 SKU 支持横向扩展/缩减,则应包含容量整数。 如果资源无法横向扩展/缩小,则可能会省略此范围。

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

-SkuFamily

如果服务具有不同代的硬件(对于同一 SKU,则可以在此处捕获)。

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

-SkuName

SKU 的名称。 Ex - P3. 它通常是字母+数字代码

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

-SkuSize

SKU 大小。 当名称字段是层和其他一些值的组合时,这将是独立的代码。

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

-SkuTier

如果服务具有多个层,但在 PUT 上不需要,则需要资源提供程序实现此字段。

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

-StorageAccountId

与此工作区关联的存储帐户的 ARM ID。 创建工作区后,无法更改此更改

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

-SubscriptionId

目标订阅的 ID。

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

包含定义为键/值对的资源标记。

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

-V1LegacyMode

启用 v1_legacy_mode 可能会阻止你使用 v2 API 提供的功能。

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

-WhatIf

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

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

输出

IWorkspace

备注

别名

复杂参数属性

若要创建下面所述的参数,请构造一个包含相应属性的哈希表。 有关哈希表的信息,请运行 Get-Help about_Hash_Tables。

SHAREDPRIVATELINKRESOURCE <ISharedPrivateLinkResource[]>:此工作区中共享的专用链接资源列表。

  • [GroupId <String>]:专用链接资源组 ID。
  • [Name <String>]:专用链接的唯一名称。
  • [PrivateLinkResourceId <String>]:专用链接链接到的资源 ID。
  • [RequestMessage <String>]:请求消息。
  • [Status <PrivateEndpointServiceConnectionStatus?>]:指示连接是否已被服务的所有者批准/拒绝/删除。