Update-AzRecoveryServicesVault

Updates MSIdentity ke vault layanan pemulihan.

Sintaks

Update-AzRecoveryServicesVault
      [-ResourceGroupName] <String>
      [-Name] <String>
      -IdentityType <MSIdentity>
      [-IdentityId <String[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzRecoveryServicesVault
      [-ResourceGroupName] <String>
      [-Name] <String>
      [-IdentityId <String[]>]
      [-RemoveUserAssigned]
      [-RemoveSystemAssigned]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Cmdlet ini digunakan untuk menambahkan atau menghapus MSI dari vault layanan pemulihan. Gunakan param -IdentityType untuk menambahkan identitas SystemAssigned/UserAssigned ke RSVault. Gunakan switch RemoveSystemAssigned/RemoveUserAssigned untuk menghapus MSI dari vault.

Contoh

Contoh 1: Menambahkan identitas SystemAssigned ke vault layanan pemulihan

Update-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName" -IdentityType SystemAssigned

Cmdlet ini digunakan untuk menambahkan identitas SystemAssigned ke vault layanan pemulihan.

Contoh 2: Menambahkan identitas UserAssigned ke vault layanan pemulihan

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$identity1 = Get-AzUserAssignedIdentity -ResourceGroupName "resourceGroupName" -Name "UserIdentity1"
$identity2 = Get-AzUserAssignedIdentity -ResourceGroupName "resourceGroupName" -Name "UserIdentity2"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -IdentityType UserAssigned -IdentityId $identity1.Id, $identity2.Id
$updatedVault.Identity | Format-List

PrincipalId            :
TenantId               : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Type                   : UserAssigned
UserAssignedIdentities : {[/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/UserIdentity1,
                         Microsoft.Azure.Management.RecoveryServices.Models.UserIdentity],
                         [/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/UserIdentity2,
                         Microsoft.Azure.Management.RecoveryServices.Models.UserIdentity]}

Cmdlet pertama mengambil vault layanan pemulihan. Cmdlet kedua dan ketiga mengambil MSI yang dibuat pengguna. Cmdlet keempat menambahkan MSI pengguna ke vault. Cmdlet kelima menunjukkan Identitas yang ditambahkan ke vault.

Contoh 3: Menghapus identitas SystemAssigned dan UserAssigned dari vault

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -RemoveSystemAssigned
$AllUserIdentities =  $vault.Identity.UserAssignedIdentities.Keys | ForEach-Object {$_} 
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -RemoveUserAssigned -IdentityId $AllUserIdentities
$updatedVault.Identity | Format-List

PrincipalId            :
TenantId               :
Type                   : None
UserAssignedIdentities :

Cmdlet pertama mengambil vault layanan pemulihan. Cmdlet kedua menghapus identitas SystemAssigned dari vault. Cmdlet ketiga mengambil semua MSI pengguna sebagai daftar dari vault. Cmdlet keempat menghapus semua MSI pengguna dari vault. Jika mau, Anda dapat memberikan identitas pengguna yang dipilih untuk dihapus sebagai dipisahkan koma, seperti dalam contoh sebelumnya. Cmdlet kelima menunjukkan identitas di brankas, saat kami menghapus semua identitas, Jenis ditampilkan sebagai Tidak Ada.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IdentityId

ID ARM dari UserAssigned Identity yang akan ditambahkan/dihapus. Ini adalah daftar Id Identitas yang dipisahkan koma.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IdentityType

Jenis MSI yang ditetapkan ke Vault Layanan Pemulihan.

Type:MSIdentity
Accepted values:SystemAssigned, None, UserAssigned
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Menentukan nama vault layanan pemulihan yang akan diperbarui.

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveSystemAssigned

Berikan sakelar ini untuk menghapus SystemAssigned Identity dari vault.

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

Berikan sakelar ini untuk menghapus UserAssigned Identity dari vault. Selain itu, berikan parameter IdenityId bersama dengan sakelar ini.

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

Menentukan nama grup sumber daya Azure tempat vault layanan pemulihan berada.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

String

Output

Vault