Set-AadrmKeyProperties

Başvuru

Modül:: AADRM

Rights Management için kiracı anahtarı nesnesinin özelliklerini Güncelleştirmeler.

Syntax

Set-AadrmKeyProperties
   [-Force]
   -KeyIdentifier <string>
   -Active <Bool>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Not

AADRM modülündeki bu cmdlet artık kullanım dışıdır. 15 Temmuz 2020'nin ardından, bu cmdlet adı yalnızca AIPService modülündeki yerini alacak diğer ad olarak desteklenecektir.

Daha fazla bilgi için genel bakış sayfasına bakın.

Set-AadrmKeyProperties cmdlet'i, kiracının Etkin olması için belirtilen anahtar nesnesinin Arşivlenmiş durumunu değiştirir. Bir kerede yalnızca bir etkin kiracı anahtarı olabileceğinden, önceden etkin olan kiracı anahtarı otomatik olarak Arşivlenmiş olarak ayarlanır.

Azure Rights Management hizmetinin yeni kullanıcıları, içeriği korumak için tanımlanan kiracı anahtarını hemen kullanır. Hizmetin mevcut kullanıcıları, daha önce etkin olan kiracı anahtarından yeni etkin kiracı anahtarına aşamalı olarak geçiş gerçekleştirir ve bu aşamalı geçişin tamamlanması birkaç hafta sürebilir. Kullanıcı ortamını yeniden başlatarak (bootstrapping olarak da bilinir) istemcilerde güncelleştirmeyi zorlayabilirsiniz. Daha önce etkin olan kiracı anahtarıyla korunan belgeler ve dosyalar, artık arşivlenmiş olan kiracı anahtarını kullanarak yetkili kullanıcılar tarafından erişilebilir durumda kalır.

Kiracı anahtarı nesne durumunu Etkin olarak ayarlamak, tüm şablonları da yeni etkin kiracı anahtarıyla yeniden imzalar. Bu işlem zaman alan bir işlem olabileceği için, özellikle de çok sayıda şablonunuz varsa, bu işlemi sık sık çalıştırmanızı önermeyiz.

Bu cmdlet'i çalıştırmak için, Etkin olarak ayarlamak istediğiniz kiracı anahtarı nesnesi için KeyIdentifier'ı belirtmeniz gerekir. Bu değeri almak için Get-AadrmKeys cmdlet'ini kullanın.

AD RMS'den geçişin ortasında değilseniz, yetersiz koruma düzeyi olarak kabul edilen 1024 bit RSA anahtarını etkinleştirmeyin. Microsoft, 1024 bit RSA anahtarları gibi daha düşük anahtar uzunluklarının ve SHA-1 gibi yetersiz koruma düzeyleri sunan protokollerin ilişkili kullanımını onaylamaz. Daha yüksek bir anahtar uzunluğuna geçmenizi öneririz.

Etkin durumunu Arşivlenecek şekilde değiştirmek için bu cmdlet'i kullanamayacağınızı unutmayın. Bir kiracı anahtarı nesnesini Arşivlenmiş durumuna sahip olacak şekilde ayarlamak için, başka bir kiracı anahtarı nesnesini Etkin olarak ayarlamanız gerekir.

Kiracı anahtarı hakkında daha fazla bilgi için bkz. Azure Information Protection kiracı anahtarınızı planlama ve uygulama.

Örnekler

Örnek 1: Kiracı anahtarı nesnesinin durumunu etkin olacak şekilde değiştirme

PS C:\> Set-AadrmKeyProperties -Force -KeyIdentifier "c0f102b3-02cc-4816-b732-fcee73edd0e6" -Active $True

Bu komut, bir kiracı anahtar nesnesinin durumunu Arşivlenmiş'ten Etkin'e değiştirir. KeyIdentifier parametresi değiştirilecek kiracı anahtarı nesnesini tanımlar ve bu değer Get-AadrmKeys çalıştırılarak bulunabilir. Daha önce Etkin durumunda olan kiracı anahtarı nesnesi otomatik olarak Arşivlenmiş olarak ayarlanır.

Komutu Force parametresini belirttiğinden, komut sizden onay istemez.

Parametreler

-Active

Kiracı anahtarı nesnesinin durumunu ayarlar.

Bu parametre yalnızca durumu Etkin olarak ayarlayan $True değeriyle kullanılabilir. Kiracı anahtarı nesnesinin durumunu Arşivlenmiş olarak değiştirmek istiyorsanız, başka bir kiracı anahtarı nesnesini Etkin olarak ayarlamanız gerekir.

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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

-Force

Komutu, kullanıcı onayı istemeden çalışmaya zorlar.

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

-KeyIdentifier

Kiracı anahtar nesnesi için anahtar tanımlayıcısını belirtir. Get-AadrmKeys komutunu çalıştırarak bu değeri alabilirsiniz.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Get-AadrmKeys