Share via

Register-SecretVault

  • 참조
모듈:
Microsoft.PowerShell.SecretManagement

현재 사용자에 대한 SecretManagement 확장 자격 증명 모음 모듈을 등록합니다.

Syntax

Register-SecretVault
        [-ModuleName] <String>
        [[-Name] <String>]
        [-VaultParameters <Hashtable>]
        [-DefaultVault]
        [-AllowClobber]
        [-PassThru]
        [-Description <String>]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]

Description

이 cmdlet은 SecretManagement 확장 자격 증명 모음을 현재 사용자의 자격 증명 모음 레지스트리에 추가합니다. 확장 자격 증명 모음은 필요한 확장 자격 증명 모음 형식을 준수하는 PowerShell 모듈입니다. 이 cmdlet은 지정된 모듈이 확장 자격 증명 모음 레지스트리에 추가하기 전에 규칙 요구 사항을 충족하는지 확인합니다. 확장 자격 증명 모음은 현재 사용자에게 등록되며 다른 사용자 자격 증명 모음 등록에는 영향을 미치지 않습니다.

이 cmdlet에 등록된 첫 번째 자격 증명 모음은 DefaultVault 매개 변수가 지정되지 않은 경우에도 자동으로 기본 자격 증명 모음으로 정의됩니다.

예제

예 1

Register-SecretVault -Name LocalStore -ModuleName Microsoft.PowerShell.SecretStore -DefaultVault
Get-SecretVault

VaultName  ModuleName                        IsDefaultVault
---------  ----------                        --------------
CredMan    Microsoft.PowerShell.CredManStore False
LocalStore Microsoft.PowerShell.SecretStore  True

다음은 현재 사용자에 대한 Microsoft.PowerShell.SecretStore 확장 자격 증명 모음을 등록하는 예제입니다. DefaultVault 매개 변수를 사용하여 등록된 자격 증명 모음을 사용자의 기본 자격 증명 모음으로 만듭니다. Get-SecretVault 는 사용자의 등록된 모든 자격 증명 모음을 나열하여 자격 증명 모음이 등록되어 있고 기본 자격 증명 모음으로 설정되었는지 확인합니다.

예 2

$parameters = @{
    Name = 'Azure'
    ModuleName = 'Az.KeyVault'
    VaultParameters = @{
        AZKVaultName = 'AzureKeyVault'
        SubscriptionId = (Get-AzContext).Subscription.Id
    }
    DefaultVault = $true
}
Register-SecretVault @parameters
Get-SecretVault

Name  ModuleName  IsDefaultVault
----  ----------  --------------
Azure Az.KeyVault True

다음은 현재 사용자에 대한 Az.KeyVault 확장 자격 증명 모음을 등록하는 예제입니다. Az.KeyVault 모듈은 이전에 설치해야 합니다. VaultParameters의 경우:

  • AZKVaultName는 Azure에서 Key Vault 이름을 지정합니다.
  • SubscriptionId는 Key Vault 만들어지는 구독의 ID를 지정합니다.

매개 변수

-AllowClobber

지정된 경우 cmdlet에서 동일한 이름으로 등록된 기존 확장 자격 증명 모음을 덮어쓸 수 있습니다.

Type:SwitchParameter
Position:Named
Default value:False
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

-DefaultVault

지정된 경우 새 확장 자격 증명 모음을 현재 사용자의 기본 자격 증명 모음으로 설정합니다.

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

-Description

자격 증명 모음에 대해 설명합니다. 이 값은 자격 증명 모음 레지스트리 정보에 포함됩니다.

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

-ModuleName

확장 자격 증명 모음을 구현하는 PowerShell 모듈의 이름을 지정합니다. 모듈의 이름 또는 모듈의 경로를 입력합니다. 이름을 지정하는 경우 PowerShell은 알려진 모듈 경로에서 이름을 검색합니다. 경로를 지정하면 PowerShell에서 해당 경로를 검색하여 모듈을 검색합니다.

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

-Name

확장 자격 증명 모음의 이름을 지정합니다. 이름을 지정하지 않으면 모듈 이름이 자격 증명 모음 이름으로 사용됩니다.

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

-PassThru

cmdlet이 성공적으로 등록된 확장 자격 증명 모음에 대한 SecretVaultInfo 개체를 반환해야 했음을 나타냅니다. 기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

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

-VaultParameters

확장 자격 증명 모음에서 매개 변수로 사용되는 선택적 키-값 쌍을 포함하는 Hashtable 개체를 지정합니다. 이러한 매개 변수는 선택 사항입니다. 필요한 값을 확인하려면 자격 증명 모음 확장 모듈의 설명서를 참조하세요.

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

입력

None

출력

None