New-AzStorageActionTask
지정된 매개 변수를 사용하여 새 스토리지 작업 리소스를 비동기적으로 만듭니다.
스토리지 작업이 이미 만들어지고 후속 만들기 요청이 다른 속성으로 발급되면 스토리지 작업 속성이 업데이트됩니다.
스토리지 작업이 이미 만들어지고 동일한 속성 집합으로 후속 만들기 요청이 실행되면 요청이 성공합니다.
구문
CreateExpanded (기본값)
New-AzStorageActionTask
-Name <String>
-ResourceGroupName <String>
-Description <String>
-IfCondition <String>
-IfOperation <IStorageTaskOperation[]>
-Location <String>
[-SubscriptionId <String>]
[-Enabled]
[-ElseOperation <IStorageTaskOperation[]>]
[-EnableSystemAssignedIdentity]
[-Tag <Hashtable>]
[-UserAssignedIdentity <String[]>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaJsonFilePath
New-AzStorageActionTask
-Name <String>
-ResourceGroupName <String>
-JsonFilePath <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaJsonString
New-AzStorageActionTask
-Name <String>
-ResourceGroupName <String>
-JsonString <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
지정된 매개 변수를 사용하여 새 스토리지 작업 리소스를 비동기적으로 만듭니다.
스토리지 작업이 이미 만들어지고 후속 만들기 요청이 다른 속성으로 발급되면 스토리지 작업 속성이 업데이트됩니다.
스토리지 작업이 이미 만들어지고 동일한 속성 집합으로 후속 만들기 요청이 실행되면 요청이 성공합니다.
예제
예제 1: if 작업을 사용하여 스토리지 작업 만들기
$ifoperation = New-AzStorageActionTaskOperationObject -Name SetBlobTier -Parameter @{"tier"= "Hot"} -OnFailure break -OnSuccess continue
New-AzStorageActionTask -Name mytask1 -ResourceGroupName group001 -Location eastus2euap -Enabled -Description 'my storage task' -IfCondition "[[equals(AccessTier, 'Cool')]]" -IfOperation $ifoperation
CreationTimeInUtc : 1/23/2024 6:47:43 AM
Description : my storage task
ElseOperation :
Enabled : True
Id : /subscriptions/11111111-2222-3333-4444-123456789101/resourceGroups/group001/providers/Microsoft.StorageActions/storageTasks/mytask1
IdentityPrincipalId :
IdentityTenantId :
IdentityType : None
IdentityUserAssignedIdentity : {
}
IfCondition : [[equals(AccessTier, 'Cool')]]
IfOperation : {{
"name": "SetBlobTier",
"parameters": {
"tier": "Hot"
},
"onSuccess": "continue",
"onFailure": "break"
}}
Location : eastus2euap
Name : mytask1
ProvisioningState : Succeeded
ResourceGroupName : group001
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
Tag : {
}
TaskVersion : 1
Type : Microsoft.StorageActions/storageTasks
첫 번째 명령은 if 작업 개체를 만듭니다.
두 번째 명령은 스토리지 작업을 만듭니다.
예제 2: 사용자 할당 ID를 사용하여 스토리지 작업 만들기
$ifOperation = New-AzStorageActionTaskOperationObject -Name SetBlobTier -Parameter @{"tier"= "Hot"} -OnFailure break -OnSuccess continue
$elseoperation = New-AzStorageActionTaskOperationObject -Name DeleteBlob -OnFailure break -OnSuccess continue
$mi = New-AzUserAssignedIdentity -Name testUserAssignedMI -ResourceGroupName group001 -Location eastus2euap
New-AzStorageActionTask -Name mytask2 -ResourceGroupName group001 -Location eastus2euap -Enabled -Description 'my storage task 2' -IfCondition "[[equals(AccessTier, 'Hot')]]" -IfOperation $ifoperation -ElseOperation $elseoperation -UserAssignedIdentity $mi.Id
CreationTimeInUtc : 5/6/2024 9:41:50 AM
Description : my storage task 2
ElseOperation : {{
"name": "DeleteBlob",
"onSuccess": "continue",
"onFailure": "break"
}}
Enabled : True
Id : /subscriptions/11111111-2222-3333-4444-123456789101/resourceGroups/group001/providers/Microsoft.StorageActions/storageTasks/mytask2
IdentityPrincipalId :
IdentityTenantId : 11111111-2222-3333-4444-123456789101
IdentityType : UserAssigned
IdentityUserAssignedIdentity : {
"/subscriptions/11111111-2222-3333-4444-123456789101/resourcegroups/group001/providers/Microsoft.ManagedIdentity/userAssignedI
dentities/testUserAssignedMI": {
}
}
IfCondition : [[equals(AccessTier, 'Hot')]]
IfOperation : {{
"name": "SetBlobTier",
"parameters": {
"tier": "Hot"
},
"onSuccess": "continue",
"onFailure": "break"
}}
Location : eastus2euap
Name : mytask2
ProvisioningState : Succeeded
ResourceGroupName : group001
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
Tag : {
}
TaskVersion : 1
Type : Microsoft.StorageActions/storageTasks
첫 번째 명령은 if 작업 개체를 만듭니다.
두 번째 명령은 다른 작업 개체를 만듭니다.
이 세 번째 명령은 스토리지 작업을 만듭니다.
예제 3: if 및 else 작업을 사용하여 스토리지 작업 만들기
$ifOperation = New-AzStorageActionTaskOperationObject -Name SetBlobTier -Parameter @{"tier"= "Cool"} -OnFailure break -OnSuccess continue
$elseoperation = New-AzStorageActionTaskOperationObject -Name DeleteBlob -OnFailure break -OnSuccess continue
New-AzStorageActionTask -Name mytask3 -ResourceGroupName group001 -Location eastus2euap -Enabled -Description 'my storage task 3' -IfCondition "[[equals(AccessTier, 'Cool')]]" -IfOperation $ifoperation -ElseOperation $elseoperation -EnableSystemAssignedIdentity
CreationTimeInUtc : 4/12/2024 9:56:05 AM
Description : my storage task 3
ElseOperation : {{
"name": "DeleteBlob",
"onSuccess": "continue",
"onFailure": "break"
}}
Enabled : True
Id : /subscriptions/11111111-2222-3333-4444-123456789101/resourceGroups/group001/providers/Microsoft.StorageActions/storageTasks/mytask3
IdentityPrincipalId : 00001111-aaaa-2222-bbbb-3333cccc4444
IdentityTenantId : 11111111-2222-3333-4444-123456789101
IdentityType : SystemAssigned
IdentityUserAssignedIdentity : {
}
IfCondition : [[equals(AccessTier, 'Cool')]]
IfOperation : {{
"name": "SetBlobTier",
"parameters": {
"tier": "Cool"
},
"onSuccess": "continue",
"onFailure": "break"
}}
Location : eastus2euap
Name : mytask3
ProvisioningState : Succeeded
ResourceGroupName : group001
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
Tag : {
}
TaskVersion : 1
Type : Microsoft.StorageActions/storageTasks
첫 번째 명령은 if 작업 개체를 만듭니다.
두 번째 명령은 다른 작업 개체를 만듭니다.
이 세 번째 명령은 스토리지 작업을 만듭니다.
매개 변수
-AsJob
작업으로 명령 실행
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
형식: SwitchParameter
Default value: None 와일드카드 지원: False DontShow: False 별칭: cf(cf)
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-DefaultProfile
DefaultProfile 매개 변수가 작동하지 않습니다.
다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.
매개 변수 속성
형식: PSObject
Default value: None 와일드카드 지원: False DontShow: False 별칭: AzureRMContext, AzureCredential
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Description
스토리지 작업의 목적을 설명하는 텍스트
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
CreateExpanded
Position: Named 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-ElseOperation
다른 블록에서 실행할 작업 목록
매개 변수 속성
매개 변수 집합
CreateExpanded
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Enabled
true로 설정하면 스토리지 작업이 활성화되고 false로 설정되면 사용하지 않도록 설정됩니다.
매개 변수 속성
매개 변수 집합
CreateExpanded
Position: Named 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-EnableSystemAssignedIdentity
리소스에 대해 시스템 할당 ID를 사용하도록 설정할지 여부를 결정합니다.
매개 변수 속성
매개 변수 집합
CreateExpanded
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-IfCondition
각 개체를 평가하기 위한 조건자입니다.
유효한 속성 및 연산자는 https://aka.ms/storagetaskconditions 참조하세요.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
CreateExpanded
Position: Named 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-IfOperation
조건자가 충족되는 경우 실행할 작업 목록입니다.
매개 변수 속성
매개 변수 집합
CreateExpanded
Position: Named 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-JsonFilePath
만들기 작업에 제공된 Json 파일의 경로
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
CreateViaJsonFilePath
Position: Named 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-JsonString
만들기 작업에 제공된 Json 문자열
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
CreateViaJsonString
Position: Named 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Location
리소스가 있는 지리적 위치
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
CreateExpanded
Position: Named 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Name
지정된 리소스 그룹 내의 스토리지 작업의 이름입니다.
스토리지 작업 이름은 길이가 3자에서 18자 사이여야 하며 숫자와 소문자만 사용해야 합니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False 별칭: StorageTaskName
매개 변수 집합
(All)
Position: Named 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-NoWait
명령을 비동기적으로 실행
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-ResourceGroupName
리소스 그룹의 이름입니다.
이름은 대소문자를 구분하지 않습니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-SubscriptionId
대상 구독의 ID입니다.
값은 UUID여야 합니다.
매개 변수 속성
형식: String
Default value: (Get-AzContext).Subscription.Id 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Tag
리소스 태그.
매개 변수 속성
형식: Hashtable
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
CreateExpanded
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-UserAssignedIdentity
리소스와 연결된 사용자 할당 ID의 배열입니다.
배열의 요소는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.
매개 변수 속성
형식: String [ ]
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
CreateExpanded
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요.
cmdlet이 실행되지 않습니다.
매개 변수 속성
형식: SwitchParameter
Default value: None 와일드카드 지원: False DontShow: False 별칭: 위스콘신
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters 를 참조하세요.
출력
