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

New-AzEdgeOrderItem

  • 参考
模块:
Az.EdgeOrder

创建订单项。 现有订单项不能使用此 API 进行更新，应改为使用更新订单项 API 进行更新。

语法

New-AzEdgeOrderItem
   -Name <String>
   -ResourceGroupName <String>
   -ForwardAddressContactDetail <IContactDetails>
   -Location <String>
   -OrderId <String>
   -OrderItemDetail <IOrderItemDetails>
   [-SubscriptionId <String>]
   [-ForwardShippingAddress <IShippingAddress>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

说明

创建订单项。 现有订单项不能使用此 API 进行更新，应改为使用更新订单项 API 进行更新。

示例

示例 1：创建新的 orderItem

$contactDetail = New-AzEdgeOrderContactDetailsObject -ContactName ContactName -EmailList @("emailId") -Phone Phone
$ShippingDetails = New-AzEdgeOrderShippingAddressObject -StreetAddress1 "101 TOWNSEND ST" -StateOrProvince "CA" -Country "US" -City "San Francisco" -PostalCode "94107" -AddressType "Commercial"
$HierarchyInformation=New-AzEdgeOrderHierarchyInformationObject -ProductFamilyName "azurestackedge" -ProductLineName "azurestackedge" -ProductName "azurestackedgegpu" -ConfigurationName "EdgeP_High"
$details = New-AzEdgeOrderOrderItemDetailsObject -OrderItemType "Purchase"  -ProductDetail  @{"HierarchyInformation"=$HierarchyInformation}
$orderItem = New-AzEdgeOrderItem -Name "examplePowershell" -ResourceGroupName ResourceGroup -ForwardAddressContactDetail $contactDetail -Location "eastus" -OrderId "/subscriptions/SubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.EdgeOrder/locations/eastus/orders/pwOrderItem11" -OrderItemDetail $details -SubscriptionId SubscriptionId -ForwardShippingAddress $ShippingDetails

$orderItem = New-AzEdgeOrderItem -Name "examplePowershell" -ResourceGroupName "resourceGroupName" -ForwardAddressContactDetail $contactDetail -Location "eastus" -OrderId "/subscriptions/SubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.EdgeOrder/locations/eastus/orders/pwOrderItem11" -OrderItemDetail $details -SubscriptionId SubscriptionId -ForwardShippingAddress $ShippingDetails
$DebugPreference = "Continue"
# You can use `$DebugPreference = "Continue"`, with any example/usecase to get exact details of error in below format when creation command fails.
# {
#   "Error": {
#     "Code": "StaticValidationGenericCountryCodeHasInvalidLength",
#     "Message": "The attribute country code does not meet length constraints.\r\nEnter a value with 2 characters for country code.",
#     "Details": [
#       null
#     ],
#     "Target": null
#   }
# } 
$orderItem = New-AzEdgeOrderItem -Name "examplePowershell" -ResourceGroupName "resourceGroupName" -ForwardAddressContactDetail $contactDetail -Location "eastus" -OrderId "/subscriptions/SubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.EdgeOrder/locations/eastus/orders/pwOrderItem11" -OrderItemDetail $details -SubscriptionId SubscriptionId -ForwardShippingAddress $ShippingDetails
$orderItem | Format-List

ForwardAddressContactDetail    : Microsoft.Azure.PowerShell.Cmdlets.EdgeOrder.Models.Api20211201.ContactDetails
ForwardAddressShippingAddress  : Microsoft.Azure.PowerShell.Cmdlets.EdgeOrder.Models.Api20211201.ShippingAddress
ForwardAddressValidationStatus : Valid
Id                             : /subscriptions/SubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.EdgeOrder/orderItems/examplePowershell
Location                       : eastus
Name                           : examplePowershell
OrderId                        : /subscriptions/SubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.EdgeOrder/locations/eastus/orders/pwOrderItem11
OrderItemDetail                : Microsoft.Azure.PowerShell.Cmdlets.EdgeOrder.Models.Api20211201.OrderItemDetails
ReturnAddressContactDetail     : Microsoft.Azure.PowerShell.Cmdlets.EdgeOrder.Models.Api20211201.ContactDetails
ReturnAddressShippingAddress   : Microsoft.Azure.PowerShell.Cmdlets.EdgeOrder.Models.Api20211201.ShippingAddress
ReturnAddressValidationStatus  :
StartTime                      : 11/16/2021 10:34:51 AM
SystemData                     : Microsoft.Azure.PowerShell.Cmdlets.EdgeOrder.Models.Api20.SystemData
Tag                            : Microsoft.Azure.PowerShell.Cmdlets.EdgeOrder.Models.Api20.TrackedResourceTags
Type                           : Microsoft.EdgeOrder/orderItems

创建新的 orderItem。

示例 2：创建一个新的 orderItem，其首选项设置为传输、加密和管理资源

$contactDetail = New-AzEdgeOrderContactDetailsObject -ContactName "ContactName2" -EmailList $env.EmailList -Phone $env.Phone
$ShippingDetails = New-AzEdgeOrderShippingAddressObject -StreetAddress1 $env.StreetAddress1 -StateOrProvince $env.StateOrProvince -Country $env.Country -City $env.City -PostalCode $env.PostalCode -AddressType $env.AddressType
$HierarchyInformation=New-AzEdgeOrderHierarchyInformationObject -ProductFamilyName "azurestackedge" -ProductLineName "azurestackedge" -ProductName "azurestackedgegpu" -ConfigurationName "EdgeP_High"
$preference = New-AzEdgeOrderPreferencesObject -EncryptionPreference @{DoubleEncryptionStatus = "Disabled"} -TransportPreference @{PreferredShipmentType = "MicrosoftManaged"} -ManagementResourcePreference @{PreferredManagementResourceId = "/subscriptions/managementSubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.DataBoxEdge/DataBoxEdgeDevices/1GPUtest"}
$details = New-AzEdgeOrderOrderItemDetailsObject -OrderItemType "Purchase"  -ProductDetail  @{"HierarchyInformation"=$HierarchyInformation} -Preference $preference
New-AzEdgeOrderItem -Name "OrderItemNameWithPref" -ResourceGroupName "resourceGroupName" -ForwardAddressContactDetail $contactDetail -Location "eastus" -OrderId "/subscriptions/SubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.EdgeOrder/locations/eastus/orders/pwPrefOrder" -OrderItemDetail $details -SubscriptionId $env.SubscriptionId -ForwardShippingAddress $ShippingDetails

Location Name                  Type
-------- ----                  ----
eastus   OrderItemNameWithPref Microsoft.EdgeOrder/orderItems

创建一个新的 orderItem，其首选项集用于传输、加密和管理资源

参数

-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

-DefaultProfile

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

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

-ForwardAddressContactDetail

要构造的地址的联系人详细信息，请参阅 FORWARDADDRESSCONTACTDETAIL 属性的 NOTES 部分，并创建哈希表。

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

-ForwardShippingAddress

要构造的地址的寄送详细信息，请参阅 FORWARDSHIPPINGADDRESS 属性的 NOTES 部分，并创建哈希表。

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

-Location

资源所在的地理位置

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

-Name

订单项的名称

Type:String
Aliases:OrderItemName
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

-OrderId

订单项所属顺序的 ID

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

-OrderItemDetail

表示订单项详细信息。 若要构造，请参阅 ORDERITEMDETAIL 属性的 NOTES 部分，并创建哈希表。

Type:IOrderItemDetails
Position:Named
Default value:None
Required:True
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

-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

-WhatIf

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

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

输出

IOrderItemResource

备注

别名

复杂参数属性

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

FORWARDADDRESSCONTACTDETAIL <IContactDetails>：地址的联系人详细信息

  • ContactName <String>：联系人的联系人姓名。
  • EmailList <String[]>：要通知有关作业进度的电子邮件 ID 的列表。
  • Phone <String>：电话联系人的号码。
  • [Mobile <String>]：联系人的手机号码。
  • [PhoneExtension <String>]：电话联系人的分机号码。

FORWARDSHIPPINGADDRESS <IShippingAddress>：地址的寄送详细信息

  • Country <String>：国家/地区的名称。
  • StreetAddress1 <String>：街道地址行 1。
  • [AddressType <AddressType?>]：地址类型。
  • [City <String>]：City 的名称。
  • [CompanyName <String>]：公司名称。
  • [PostalCode <String>]：邮政编码。
  • [StateOrProvince <String>]：州或省的名称。
  • [StreetAddress2 <String>]：街道地址行 2。
  • [StreetAddress3 <String>]：街道地址行 3。
  • [ZipExtendedCode <String>]：扩展的邮政编码。

ORDERITEMDETAIL <IOrderItemDetails>：表示订单项详细信息。

  • OrderItemType <OrderItemType>：订单项类型。
  • ProductDetail <IProductDetails>：配置的唯一标识符。
    • HierarchyInformation <IHierarchyInformation>：唯一标识产品的产品的层次结构
      • [ConfigurationName <String>]：表示唯一标识配置的配置名称
      • [ProductFamilyName <String>]：表示唯一标识产品系列的产品名称
      • [ProductLineName <String>]：表示唯一标识生产线的产品名称
      • [ProductName <String>]：表示唯一标识产品的产品名称
  • [NotificationEmailList <String[]>]：其他通知电子邮件列表
  • [Preference <IPreferences>]：客户通知首选项
    • [EncryptionPreference <IEncryptionPreferences>]：与加密相关的首选项。
      • [DoubleEncryptionStatus <DoubleEncryptionStatus?>]：客户输入的双重加密状态。 如果配置了“拒绝”或“禁用”策略，则强制为此参数提供此参数。
    • [ManagementResourcePreference <IManagementResourcePreferences>]：与管理资源相关的首选项。
      • [PreferredManagementResourceId <String>]：客户首选管理资源 ARM ID
    • [NotificationPreference <INotificationPreference[]>]：通知首选项。
      • SendNotification <Boolean>：需要通知或不需要通知。
      • StageName <NotificationStageName>：阶段的名称。
    • [TransportPreference <ITransportPreferences>]：与订单的发货物流相关的首选项。
      • PreferredShipmentType <TransportShipmentTypes>：指示客户首选的发货物流类型。