New-AzKeyVaultManagedHsm

참조

모듈:: Az.KeyVault

관리형 HSM을 만듭니다.

구문

New-AzKeyVaultManagedHsm
   [-Name] <String>
   [-ResourceGroupName] <String>
   [-Location] <String>
   [-Administrator] <String[]>
   [-Sku <String>]
   -SoftDeleteRetentionInDays <Int32>
   [-PublicNetworkAccess <String>]
   [-EnablePurgeProtection]
   [-UserAssignedIdentity <String[]>]
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [-SubscriptionId <String>]
   [<CommonParameters>]

Description

New-AzKeyVaultManagedHsm cmdlet은 지정된 리소스 그룹에 관리되는 HSM을 만듭니다. 관리되는 HSM에서 키를 추가, 제거 또는 나열하려면 사용자는 다음을 수행해야 합니다.

관리자에게 사용자 ID를 추가하여 사용 권한을 부여합니다.
"관리형 HSM Crypto User"와 같은 사용자에 대한 역할 할당을 추가합니다.
Export-AzKeyVaultSecurityDomain사용하여 관리되는 HSM의 보안 도메인 데이터를 백업합니다.

예제

예제 1: StandardB1 관리형 HSM 만들기

New-AzKeyVaultManagedHsm -Name 'myhsm' -ResourceGroupName 'myrg1' -Location 'eastus2euap' -Administrator "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -SoftDeleteRetentionInDays 70

Name  Resource Group Name Location    SKU
----  ------------------- --------    ---
myhsm myrg1               eastus2euap StandardB1

이 명령은 eastus2euap 위치에 myhsm이라는 관리형 HSM을 만듭니다. 이 명령은 myrg1이라는 리소스 그룹에 관리형 HSM을 추가합니다. 명령은 SKU 매개 변수에 대한 값을 지정하지 않으므로 Standard_B1 관리되는 HSM을 만듭니다.

예제 2: CustomB32 관리형 HSM 만들기

New-AzKeyVaultManagedHsm -Name 'myhsm' -ResourceGroupName 'myrg1' -Location 'eastus2euap' -Administrator "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -Sku 'CustomB32' -SoftDeleteRetentionInDays 70

Name  Resource Group Name Location    SKU

----  ------------------- --------    ---
myhsm myrg1               eastus2euap CustomB32

이 명령은 이전 예제와 마찬가지로 관리형 HSM을 만듭니다. 그러나 SKU 매개 변수에 대한 CustomB32 값을 지정하여 CustomB32 관리형 HSM을 만듭니다.

예제 3: 사용자 할당 ID를 사용하여 관리형 HSM 만들기

New-AzKeyVaultManagedHsm -Name 'myhsm' -ResourceGroupName 'myrg1' -Location 'eastus2euap' -Administrator "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"-SoftDeleteRetentionInDays 70 -UserAssignedIdentity /subscriptions/xxxx/resourceGroups/xxxx/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName | Format-List

Managed HSM Name                        : myhsm
Resource Group Name                     : myrg1
Location                                : eastus2euap
Resource ID                             : /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/bez-rg/pro
                                          viders/Microsoft.KeyVault/managedHSMs/bezmhsm
HSM Pool URI                            :
Tenant ID                               : 00001111-aaaa-2222-bbbb-3333cccc4444
Initial Admin Object Ids                : {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
SKU                                     : StandardB1
Soft Delete Enabled?                    : True
Enabled Purge Protection?               : False
Soft Delete Retention Period (days)     : 70
Public Network Access                   : Enabled
IdentityType                            : UserAssigned
UserAssignedIdentities                  : /subscriptions/xxxx/resourceGroups/xxxx/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName
Provisioning State                      : Succeeded
Status Message                          : The Managed HSM is provisioned and ready to use.
Security Domain ActivationStatus        : Active
Security Domain ActivationStatusMessage : Your HSM has been activated and can be used for cryptographic operations.
Regions                                 : 
Tags

이 명령은 사용자 할당 ID를 사용하여 관리형 HSM을 만듭니다.

매개 변수

-Administrator

이 관리형 HSM 풀에 대한 초기 관리자 개체 ID입니다.

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

-AsJob

백그라운드에서 cmdlet 실행

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

-Confirm

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

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

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

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

-EnablePurgeProtection

이 관리형 HSM 풀에 대해 제거에 대한 보호를 사용할 수 있는지 여부를 지정합니다. 이 설정은 일시 삭제도 사용하도록 설정된 경우에만 적용됩니다. 이 기능을 사용하도록 설정하는 것은 되돌릴 수 없습니다.

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

-Location

키 자격 증명 모음을 만들 Azure 지역을 지정합니다. ProviderNamespace 매개 변수와 함께 명령 Get-AzResourceProvider 사용하여 선택 항목을 확인합니다.

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

-Name

만들 관리되는 HSM의 이름을 지정합니다. 이름은 문자, 숫자 또는 하이픈의 조합일 수 있습니다. 이름은 문자 또는 숫자로 시작하고 끝나야 합니다. 이름은 범용적으로 고유해야 합니다.

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

-PublicNetworkAccess

프라이빗 엔드포인트를 사용하는 동안 공용 네트워크에서 들어오는 데이터 평면 트래픽에 대한 권한을 제어합니다.

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

-ResourceGroupName

키 자격 증명 모음을 만들 기존 리소스 그룹의 이름을 지정합니다.

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

-Sku

관리되는 HSM 인스턴스의 SKU를 지정합니다.

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

-SoftDeleteRetentionInDays

삭제된 관리형 hsm 풀이 보존되는 기간 및 삭제된 상태의 관리되는 hsm 풀을 제거할 때까지의 기간을 지정합니다.

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

-SubscriptionId

구독의 ID입니다. 기본적으로 cmdlet은 현재 컨텍스트에서 설정된 구독에서 실행됩니다. 사용자가 다른 구독을 지정하면 현재 cmdlet이 사용자가 지정한 구독에서 실행됩니다. 구독 재정의는 현재 cmdlet의 수명 주기 동안에만 적용됩니다. 컨텍스트에서 구독을 변경하지 않으며 후속 cmdlet에는 영향을 주지 않습니다.

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

-Tag

리소스 태그를 나타내는 해시 테이블입니다.

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

-UserAssignedIdentity

관리되는 HSM과 연결된 사용자 할당 ID 집합입니다. 해당 값은 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

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

입력

String

String[]

Hashtable

출력

PSManagedHsm

다음을 통해 공유

New-AzKeyVaultManagedHsm

구문

Description

예제

예제 1: StandardB1 관리형 HSM 만들기

예제 2: CustomB32 관리형 HSM 만들기

예제 3: 사용자 할당 ID를 사용하여 관리형 HSM 만들기

매개 변수

-Administrator

-AsJob

-Confirm

-DefaultProfile

-EnablePurgeProtection

-Location

-Name

-PublicNetworkAccess

-ResourceGroupName

-Sku

-SoftDeleteRetentionInDays

-SubscriptionId

-Tag

-UserAssignedIdentity

-WhatIf

입력

출력

추가 리소스

다음을 통해 공유

New-AzKeyVaultManagedHsm

구문

Description

예제

예제 1: StandardB1 관리형 HSM 만들기

예제 2: CustomB32 관리형 HSM 만들기

예제 3: 사용자 할당 ID를 사용하여 관리형 HSM 만들기

매개 변수

-Administrator

-AsJob

-Confirm

-DefaultProfile

-EnablePurgeProtection

-Location

-Name

-PublicNetworkAccess

-ResourceGroupName

-Sku

-SoftDeleteRetentionInDays

-SubscriptionId

-Tag

-UserAssignedIdentity

-WhatIf

입력

출력

관련 링크

추가 리소스