Export-AadrmTemplate

Esporta le proprietà di un modello di criteri per i diritti di utilizzo in un file.

Sintassi

Export-AadrmTemplate
      -TemplateId <Guid>
      -Path <String>
      [-Force]
      [<CommonParameters>]

Descrizione

Nota

Questo cmdlet dal modulo AADRM è ora deprecato. Dopo il 15 luglio 2020, questo nome del cmdlet sarà supportato solo come alias per la sua sostituzione nel modulo AIPService.

Per altre informazioni, vedere la pagina panoramica.

Il cmdlet Export-AadrmTemplate esporta tutte le proprietà di un modello Rights Management in un file. È quindi possibile importare il modello in un altro tenant di Azure Rights Management oppure modificarlo e importarlo nuovamente nel tenant originale. Questo metodo è utile per eseguire modifiche in blocco di proprietà complesse in modelli, ad esempio nomi e descrizioni in più lingue.

Anche se è possibile configurare i modelli di Rights Management nella portale di Azure, è necessario usare PowerShell per esportare e importare questi modelli.

Suggerimento: considerare l'uso di questo cmdlet come modo per eseguire il backup dei modelli personalizzati, in modo che sia possibile ripristinare una versione nota, se necessario.

Il processo di esportazione non aggiunge automaticamente un'estensione al nome di file, pertanto è possibile specificare un'estensione corrispondente all'applicazione che verrà usata per visualizzare e modificare i dati risultanti.

È possibile usare il cmdlet Get-AadrmTemplate per ottenere i GUID di tutti i modelli.

Per altre informazioni sui modelli personalizzati, tra cui come configurarli nel portale di Azure, vedere Configurazione e gestione dei modelli per Azure Information Protection.

Esempio

Esempio 1: Esportare un modello

PS C:\>Export-AadrmTemplate -Path "C:\MyTemplates\MyTemplateFile.xml" -TemplateId 28168524-29c3-44f1-9e11-ea6c60bb6428

Questo comando esporta il modello specificato nel file denominato MyTemplateFile.xml.

Parametri

-Force

Indica che il cmdlet sovrascrive un file modello esistente con lo stesso percorso.

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

-Path

Specifica il percorso in cui salvare file.

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

-TemplateId

Specifica il GUID di un modello Rights Management.

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