New-AzConfidentialLedger

  • 參考
模組:
Az.ConfidentialLedger

使用指定的總賬參數建立機密總帳。

Syntax

New-AzConfidentialLedger
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-AadBasedSecurityPrincipal <IAadBasedSecurityPrincipal[]>]
   [-CertBasedSecurityPrincipal <ICertBasedSecurityPrincipal[]>]
   [-LedgerType <LedgerType>]
   [-Location <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

使用指定的總賬參數建立機密總帳。

範例

範例 1：建立新的機密總帳

New-AzConfidentialLedger `
  -Name test-ledger `
  -ResourceGroupName rg-000 `
  -SubscriptionId 00000000-0000-0000-0000-000000000000 `
  -AadBasedSecurityPrincipal `
      @{
          LedgerRoleName="Administrator";
          PrincipalId="34621747-6fc8-4771-a2eb-72f31c461f2e";
          TenantId="bce123b9-2b7b-4975-8360-5ca0b9b1cd08"
      } `
  -CertBasedSecurityPrincipal `
      @{
          Cert="-----BEGIN CERTIFICATE-----********************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************-----END CERTIFICATE-----";
          LedgerRoleName="Reader"
      } `
  -LedgerType Public `
  -Location eastus `
  -Tag @{Location="additional properties 0"}

Location Name
eastus   test-ledger

建立新的機密總賬。

範例 2：使用安全性主體物件建立

$aadSecurityPrincipal = New-AzConfidentialLedgerAADBasedSecurityPrincipalObject `
  -LedgerRoleName "Administrator" `
  -PrincipalId "34621747-6fc8-4771-a2eb-72f31c461f2e" `
  -TenantId "bce123b9-2b7b-4975-8360-5ca0b9b1cd08"

$certSecurityPrincipal = New-AzConfidentialLedgerCertBasedSecurityPrincipalObject `
  -Cert "-----BEGIN CERTIFICATE-----********************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************-----END CERTIFICATE-----" `
  -LedgerRoleName "Reader"

New-AzConfidentialLedger `
  -Name test-ledger `
  -ResourceGroupName rg-000 `
  -SubscriptionId 00000000-0000-0000-0000-000000000000 `
  -AadBasedSecurityPrincipal $aadSecurityPrincipal `
  -CertBasedSecurityPrincipal $certSecurityPrincipal `
  -LedgerType Public `
  -Location eastus `
  -Tag @{Location="additional properties 0"}

Location Name
eastus   test-ledger

使用和CertBasedSecurityPrincipal的物件AadBasedSecurityPrincipal建立新的機密總帳。

參數

-AadBasedSecurityPrincipal

所有 AAD 型安全性主體的陣列。 若要建構，請參閱 AADBASEDSECURITYPRINCIPAL 屬性的 NOTES 區段，並建立哈希表。

Type:IAadBasedSecurityPrincipal[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AsJob

以作業身分執行命令

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

-CertBasedSecurityPrincipal

所有憑證型安全性主體的陣列。 若要建構，請參閱 CERTBASEDSECURITYPRINCIPAL 屬性的 NOTES 一節，並建立哈希表。

Type:ICertBasedSecurityPrincipal[]
Position:Named
Default value:None
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

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LedgerType

機密總帳的類型

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

-Location

機密總帳執行所在的 Azure 位置。

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

-Name

機密總賬的名稱

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

-NoWait

以異步方式執行命令

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

-ResourceGroupName

資源群組的名稱。

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

-SubscriptionId

Azure 訂閱識別碼。 這是 GUID 格式的字串（例如 0000000000-0000-0000-0000-0000000000000000）

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

機密總帳的其他標籤

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

輸出

IConfidentialLedger

備註

別名

COMPLEX PARAMETER PROPERTIES

若要建立以下所述的參數，請建構包含適當屬性的哈希表。 如需哈希表的相關信息，請執行 Get-Help about_Hash_Tables。

AADBASEDSECURITYPRINCIPAL <IAadBasedSecurityPrincipal[]>： 所有 AAD 型安全性主體的數位。

  • [LedgerRoleName <LedgerRoleName?>]：總賬與總賬安全性主體相關聯的 LedgerRole
  • [PrincipalId <String>]：安全性主體的 UUID/GUID 型主體識別碼
  • [TenantId <String>]：安全性主體的 UUID/GUID 型租使用者識別碼

CERTBASEDSECURITYPRINCIPAL <ICertBasedSecurityPrincipal[]>： 所有憑證型安全性主體的數位。

  • [Cert <String>]：用戶憑證的公鑰（.pem 或.cer）
  • [LedgerRoleName <LedgerRoleName?>]：總賬與總賬安全性主體相關聯的 LedgerRole