New-AzDataProtectionBackupVault

모듈:: Az.DataProtection Module

리소스 그룹에 속한 BackupVault 리소스를 만들거나 업데이트합니다.

구문

Default (기본값)

New-AzDataProtectionBackupVault
    -ResourceGroupName <String>
    -VaultName <String>
    -Location <String>
    -StorageSetting <IStorageSetting[]>
    [-SubscriptionId <String>]
    [-ETag <String>]
    [-IdentityType <String>]
    [-AzureMonitorAlertsForAllJobFailure <AlertsState>]
    [-ImmutabilityState <ImmutabilityState>]
    [-CrossRegionRestoreState <CrossRegionRestoreState>]
    [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
    [-SoftDeleteRetentionDurationInDay <Double>]
    [-SoftDeleteState <SoftDeleteState>]
    [-Tag <Hashtable>]
    [-IdentityUserAssignedIdentity <Hashtable>]
    [-CmkEncryptionState <EncryptionState>]
    [-CmkInfrastructureEncryption <InfrastructureEncryptionState>]
    [-CmkIdentityType <IdentityType>]
    [-CmkUserAssignedIdentityId <String>]
    [-CmkEncryptionKeyUri <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

리소스 그룹에 속한 BackupVault 리소스를 만들거나 업데이트합니다.

예제

예제 1: 새 백업 자격 증명 모음 만들기

$sub = "xxxx-xxxx-xxxxx"
$storagesetting = New-AzDataProtectionBackupVaultStorageSettingObject -DataStoreType VaultStore -Type LocallyRedundant
New-AzDataProtectionBackupVault -SubscriptionId $sub -ResourceGroupName sarath-rg -VaultName "MyVault" -StorageSetting $storagesetting -Location westus

ETag IdentityPrincipalId IdentityTenantId IdentityType Location Name    Type
---- ------------------- ---------------- ------------ -------- ----    ----
                                                       westus   MyVault Microsoft.DataProtection/backupVaults

이 명령은 새 백업 자격 증명 모음을 만듭니다.

예제 2: ImmutabilityState, CrossSubscriptionRestoreState, 일시 삭제 설정을 사용하여 새 백업 자격 증명 모음 만들기

$sub = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
$storagesetting = New-AzDataProtectionBackupVaultStorageSettingObject -DataStoreType VaultStore -Type LocallyRedundant
New-AzDataProtectionBackupVault -SubscriptionId $sub -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -Location westus -StorageSetting $storagesetting -CrossSubscriptionRestoreState Enabled -ImmutabilityState Unlocked -SoftDeleteRetentionDurationInDay 100 -SoftDeleteState On

ETag IdentityPrincipalId IdentityTenantId IdentityType Location Name    Type
---- ------------------- ---------------- ------------ -------- ----    ----
                                                       westus   MyVault Microsoft.DataProtection/backupVaults

이 명령은 불변성 상태, 구독 간 복원 상태, 생성 시 자격 증명 모음의 일시 삭제 설정을 설정하는 동안 새 백업 자격 증명 모음을 만듭니다.

예제 3: CMK를 사용하여 Backup 자격 증명 모음 만들기

$storagesetting = New-AzDataProtectionBackupVaultStorageSettingObject -DataStoreType VaultStore -Type LocallyRedundant
$userAssignedIdentity = @{
    "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/samplerg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sampleuami" = @{
        clientId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        principalId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }
    "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/samplerg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sampleuami2" = @{
        clientId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        principalId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }
}

$cmkIdentityId = "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/samplerg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sampleuami"

$cmkKeyUri = "https://samplekvazbckp.vault.azure.net/keys/testkey/3cd5235ad6ac4c11b40a6f35444bcbe1"

New-AzDataProtectionBackupVault -SubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -Location "location" -StorageSetting $storagesetting -IdentityType UserAssigned -UserAssignedIdentity $userAssignedIdentity -CmkEncryptionState Enabled -CmkIdentityType UserAssigned -CmkUserAssignedIdentityId $cmkIdentityId -CmkEncryptionKeyUri $cmkKeyUri -CmkInfrastructureEncryption Enabled

Name      Location   IdentityType
--------  --------   ------------
vaultName location   UserAssigned

이 명령은 CMK 암호화를 사용하도록 설정된 백업 자격 증명 모음을 만듭니다.

매개 변수

-AsJob

리소스 그룹에 속한 BackupVault 리소스를 만들거나 업데이트합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-AzureMonitorAlertsForAllJobFailure

작업 실패에 대한 기본 제공 Azure Monitor 경고를 사용하거나 사용하지 않도록 설정하는 매개 변수입니다. 보안 경고를 사용하지 않도록 설정할 수 없습니다.

매개 변수 속성

형식:	AlertsState
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-CmkEncryptionKeyUri

암호화에 사용할 CMK 키의 키 URI입니다. 키 자동 회전을 사용하도록 설정하려면 키 URI에서 버전 구성 요소를 제외합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-CmkEncryptionState

Backup 자격 증명 모음에 CMK 암호화 상태를 사용하도록 설정합니다.

매개 변수 속성

형식:	EncryptionState
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-CmkIdentityType

CMK 암호화에 사용할 ID 형식( SystemAssigned 또는 UserAssigned IDENTITy)입니다.

매개 변수 속성

형식:	IdentityType
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-CmkInfrastructureEncryption

이 자격 증명 모음에서 CMK를 사용하여 인프라 암호화를 사용하도록 설정합니다. 인프라 암호화는 자격 증명 모음을 만들 때만 구성해야 합니다.

매개 변수 속성

형식:	InfrastructureEncryptionState
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-CmkUserAssignedIdentityId

ID 형식이 UserAssigned인 경우 이 매개 변수가 필요합니다. Key Vault에 대한 액세스 권한이 있는 사용할 사용자 할당 관리 ID ID를 추가합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(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

-CrossRegionRestoreState

자격 증명 모음의 지역 간 복원 상태입니다. 허용되는 값은 Disabled, Enabled입니다.

매개 변수 속성

형식:	CrossRegionRestoreState
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-CrossSubscriptionRestoreState

자격 증명 모음의 구독 간 복원 상태입니다. 허용되는 값은 Disabled, Enabled, PermanentlyDisabled입니다.

매개 변수 속성

형식:	CrossSubscriptionRestoreState
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DefaultProfile

리소스 그룹에 속한 BackupVault 리소스를 만들거나 업데이트합니다.

매개 변수 속성

형식:	PSObject
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	AzureRMContext, AzureCredential

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ETag

선택적 ETag입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IdentityType

identityType은 "SystemAssigned", "UserAssigned", "SystemAssigned,UserAssigned", "None" 등의 값을 사용할 수 있습니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IdentityUserAssignedIdentity

사용자 할당 ID를 가져오거나 설정합니다.

매개 변수 속성

형식:	Hashtable
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	UserAssignedIdentity, AssignUserIdentity

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ImmutabilityState

자격 증명 모음의 불변성 상태입니다. 허용되는 값은 사용 안 함, 잠금 해제됨, 잠김입니다.

매개 변수 속성

형식:	ImmutabilityState
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Location

리소스 위치입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-NoWait

리소스 그룹에 속한 BackupVault 리소스를 만들거나 업데이트합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ResourceGroupName

백업 자격 증명 모음의 리소스 그룹 이름

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-SoftDeleteRetentionDurationInDay

일시 삭제 보존 기간(일)

매개 변수 속성

형식:	Double
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-SoftDeleteState

자격 증명 모음의 일시 삭제 상태입니다. 허용되는 값은 Off, On, AlwaysOn입니다.

매개 변수 속성

형식:	SoftDeleteState
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-StorageSetting

자격 증명 모음의 스토리지 설정입니다. New-AzDataProtectionBackupVaultStorageSetting Cmdlet을 사용하여 만듭니다. 생성하려면 STORAGESETTING 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

매개 변수 속성

형식:	IStorageSetting[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-SubscriptionId

자격 증명 모음의 구독 ID

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Tag

리소스 태그.

매개 변수 속성

형식:	Hashtable
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-VaultName

백업 자격 증명 모음의 이름

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	True
파이프라인의 값:	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를 참조하세요.

출력

PSObject

피드백

이 페이지가 도움이 되었나요?

다음을 통해 공유

New-AzDataProtectionBackupVault

구문

Default (기본값)

Description

예제

예제 1: 새 백업 자격 증명 모음 만들기

예제 2: ImmutabilityState, CrossSubscriptionRestoreState, 일시 삭제 설정을 사용하여 새 백업 자격 증명 모음 만들기

예제 3: CMK를 사용하여 Backup 자격 증명 모음 만들기

매개 변수

-AsJob

매개 변수 속성

매개 변수 집합

-AzureMonitorAlertsForAllJobFailure

매개 변수 속성

매개 변수 집합

-CmkEncryptionKeyUri

매개 변수 속성

매개 변수 집합

-CmkEncryptionState

매개 변수 속성

매개 변수 집합

-CmkIdentityType

매개 변수 속성

매개 변수 집합

-CmkInfrastructureEncryption

매개 변수 속성

매개 변수 집합

-CmkUserAssignedIdentityId

매개 변수 속성

매개 변수 집합

-Confirm

매개 변수 속성

매개 변수 집합

-CrossRegionRestoreState

매개 변수 속성

매개 변수 집합

-CrossSubscriptionRestoreState

매개 변수 속성

매개 변수 집합

-DefaultProfile

매개 변수 속성

매개 변수 집합

-ETag

매개 변수 속성

매개 변수 집합

-IdentityType

매개 변수 속성

매개 변수 집합

-IdentityUserAssignedIdentity

매개 변수 속성

매개 변수 집합

-ImmutabilityState

매개 변수 속성

매개 변수 집합

-Location

매개 변수 속성

매개 변수 집합

-NoWait

매개 변수 속성

매개 변수 집합

-ResourceGroupName

매개 변수 속성

매개 변수 집합

-SoftDeleteRetentionDurationInDay

매개 변수 속성

매개 변수 집합

-SoftDeleteState

매개 변수 속성

매개 변수 집합

-StorageSetting

매개 변수 속성

매개 변수 집합

-SubscriptionId

매개 변수 속성

매개 변수 집합

-Tag

매개 변수 속성

매개 변수 집합

-VaultName