Update-AzDataBoxJob

참조

모듈:: Az.DataBox

기존 작업의 속성을 업데이트합니다.

구문

Update-AzDataBoxJob
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-IfMatch <String>]
      [-ContactDetail <IContactDetails>]
      [-ContactDetailContactName <String>]
      [-ContactDetailMobile <String>]
      [-ContactDetailPhone <String>]
      [-ContactDetailPhoneExtension <String>]
      [-EncryptionPreferenceDoubleEncryption <DoubleEncryption>]
      [-EncryptionPreferenceHardwareEncryption <HardwareEncryption>]
      [-IdentityType <String>]
      [-KeyEncryptionKey <IKeyEncryptionKey>]
      [-PreferencePreferredDataCenterRegion <String[]>]
      [-ReturnToCustomerPackageDetailCarrierAccountNumber <String>]
      [-ReturnToCustomerPackageDetailCarrierName <String>]
      [-ReturnToCustomerPackageDetailTrackingId <String>]
      [-ReverseShippingDetail <IShippingAddress>]
      [-ReverseTransportPreferredShipmentType <TransportShipmentTypes>]
      [-ShippingAddress <IShippingAddress>]
      [-StorageAccountAccessTierPreference <StorageAccountAccessTier[]>]
      [-Tag <Hashtable>]
      [-TransportPreferredShipmentType <TransportShipmentTypes>]
      [-UserAssignedIdentity <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

기존 작업의 속성을 업데이트합니다.

예제

예제 1: 사용자 할당 ID를 사용하여 관리되는 Microsoft에서 고객으로 데이터 상자 작업 암호화 업데이트

$keyEncryptionDetails = New-AzDataBoxKeyEncryptionKeyObject -KekType "CustomerManaged" -IdentityProperty @{Type = "UserAssigned"; UserAssignedResourceId = "/subscriptions/SubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName"} -KekUrl "keyIdentifier" -KekVaultResourceId "/subscriptions/SubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.KeyVault/vaults/keyVaultName"

$DebugPreference = "Continue"

# You can use `$DebugPreference = "Continue"`, with any example/usecase to get exact details of error in below format when update 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
#   }
# } 

Update-AzDataBoxJob -Name "powershell10" -ResourceGroupName "resourceGroupName" -KeyEncryptionKey $keyEncryptionDetails -ContactDetail $contactDetail -ShippingAddress $ShippingDetails  -IdentityType "UserAssigned" -UserAssignedIdentity @{"/subscriptions/SubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName" = @{}}

$keyEncryptionDetails

KekType         KekUrl                                           KekVaultResourceId
-------         ------                                           ------------------
CustomerManaged keyIdentifier /subscriptions/SubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.KeyVault/vaults/keyVaultName

Name         Location Status        TransferType  SkuName IdentityType DeliveryType Detail
----         -------- ------        ------------  ------- ------------ ------------ ------
Powershell10 WestUS   DeviceOrdered ImportToAzure DataBox UserAssigned NonScheduled Microsoft.Azure.PowerShell.Cmdlets.DataBox.Models.Api20210301.DataBoxJobDetails

Microsoft에서 관리되는 데이터 상자 작업 암호화를 사용자 할당 ID로 관리되는 고객으로 업데이트합니다.

예제 2: 2개 업데이트에서 시스템 ID를 사용하여 관리되는 고객으로 관리되는 Microsoft의 데이터 상자 작업 암호화 업데이트

$databoxUpdate = Update-AzDataBoxJob -Name "pwshTestSAssigned" -ResourceGroupName "resourceGroupName" -ContactDetail $contactDetail -ShippingAddress $ShippingDetails  -IdentityType "SystemAssigned"

$databoxUpdate.Identity

$keyEncryptionDetails = New-AzDataBoxKeyEncryptionKeyObject -KekType "CustomerManaged" -IdentityProperty @{Type = "SystemAssigned"} -KekUrl "keyIdentifier" -KekVaultResourceId "/subscriptions/SubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.KeyVault/vaults/keyVaultName"

$databoxUpdateWithCMK = Update-AzDataBoxJob -Name "pwshTestSAssigned" -ResourceGroupName "resourceGroupName" -ContactDetail $contactDetail -ShippingAddress $ShippingDetails  -KeyEncryptionKey $keyEncryptionDetails

$databoxUpdateWithCMK.Identity

$databoxUpdateWithCMK.Detail.KeyEncryptionKey

PrincipalId                          TenantId                             Type
-----------                          --------                             ----
920850f5-9b6b-4017-a81a-3dcafe348be7 72f988bf-86f1-41af-91ab-2d7cd011db47 SystemAssigned

PrincipalId                          TenantId                             Type
-----------                          --------                             ----
920850f5-9b6b-4017-a81a-3dcafe348be7 72f988bf-86f1-41af-91ab-2d7cd011db47 SystemAssigned

KekType         KekUrl                                           KekVaultResourceId
-------         ------                                           ------------------
CustomerManaged keyIdentifier /subscriptions/SubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.KeyVault/vaults/keyVaultName

관리되는 Microsoft에서 관리되는 고객으로 데이터 상자 작업 암호화를 업데이트하여 시스템 할당 ID를 사용하여 관리되는 고객으로 업데이트합니다. 예제 1에 설명된 대로 $DebugPreference = "계속"을 사용하여 다시 실행되는 오류의 경우

예제 3: 고객 관리형 키 암호화를 사용하여 할당된 사용자에게 할당된 시스템에서 데이터 상자 작업 업데이트

$contactDetail = New-AzDataBoxContactDetailsObject -ContactName "random" -EmailList @("emailId") -Phone "1234567891"
$ShippingDetails = New-AzDataBoxShippingAddressObject -StreetAddress1 "101 TOWNSEND ST" -StateOrProvince "CA" -Country "US" -City "San Francisco" -PostalCode "94107" -AddressType "Commercial"

Update-AzDataBoxJob -Name "pwshTestSAssigned" -ResourceGroupName "resourceGroupName" -KeyEncryptionKey $keyEncryptionDetails -ContactDetail $contactDetail -ShippingAddress $ShippingDetails  -IdentityType "SystemAssigned,UserAssigned" -UserAssignedIdentity @{"/subscriptions/SubscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName" = @{}}

고객 관리형 키 암호화를 사용하여 할당된 사용자에게 할당된 시스템에서 데이터 상자 작업을 업데이트합니다. 예제 1에 설명된 대로 $DebugPreference = "계속"을 사용하여 다시 실행되는 오류의 경우

매개 변수

-AsJob

작업으로 명령 실행

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ContactDetail

알림 및 배송에 대한 연락처 세부 정보입니다. 생성하려면 CONTACTDETAIL 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

형식:	IContactDetails
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ContactDetailContactName

사용자의 연락처 이름입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ContactDetailMobile

대화 상대의 휴대폰 번호입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ContactDetailPhone

대화 상대의 전화 번호입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ContactDetailPhoneExtension

연락처의 전화 확장 번호입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultProfile

DefaultProfile 매개 변수가 작동하지 않습니다. 다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.

형식:	PSObject
별칭:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EncryptionPreferenceDoubleEncryption

소프트웨어 기반 암호화 사용의 보조 계층을 정의합니다.

형식:	DoubleEncryption
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EncryptionPreferenceHardwareEncryption

하드웨어 수준 암호화 정의(디스크에만 해당)

형식:	HardwareEncryption
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-IdentityType

ID 유형

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-IfMatch

If-Match 조건을 정의합니다. 패치는 서버에서 작업의 ETag가 이 값과 일치하는 경우에만 수행됩니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-KeyEncryptionKey

작업에 대한 키 암호화 키입니다. 생성하려면 KEYENCRYPTIONKEY 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

형식:	IKeyEncryptionKey
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Name

지정된 리소스 그룹 내의 작업 리소스 이름입니다. 작업 이름은 길이가 3자에서 24자 사이여야 하며 영숫자와 밑줄만 사용해야 합니다.

형식:	String
별칭:	JobName
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NoWait

명령을 비동기적으로 실행

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PreferencePreferredDataCenterRegion

기본 설정 데이터 센터 지역입니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ResourceGroupName

리소스 그룹 이름

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ReturnToCustomerPackageDetailCarrierAccountNumber

고객 디스크의 운송업체 계정 고객 수입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ReturnToCustomerPackageDetailCarrierName

이동 통신 사업자의 이름입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ReturnToCustomerPackageDetailTrackingId

배송의 추적 ID입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ReverseShippingDetail

고객이 디바이스를 받으려는 배송 주소입니다. 생성하려면 REVERSESHIPPINGDETAIL 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

형식:	IShippingAddress
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ReverseTransportPreferredShipmentType

고객이 선호하는 배송 물류 유형을 나타냅니다.

형식:	TransportShipmentTypes
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ShippingAddress

고객의 배송 주소입니다. 생성하려면 SHIPPINGADDRESS 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

형식:	IShippingAddress
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-StorageAccountAccessTierPreference

스토리지 계정의 액세스 계층과 관련된 기본 설정입니다.

형식:	StorageAccountAccessTier[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SubscriptionId

구독 ID

형식:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Tag

리소스를 설명하는 키 값 쌍의 목록입니다. 이러한 태그는 리소스 그룹 전체에서 이 리소스를 보고 그룹화할 때 사용할 수 있습니다.

형식:	Hashtable
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-TransportPreferredShipmentType