Share via

New-AzAutomationModule

  • Referência
Módulo:
Az.Automation

Importa um módulo para Automação.

Syntax

New-AzAutomationModule
   [-Name] <String>
   [-ContentLinkUri] <Uri>
   [-RuntimeVersion <String>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet New-AzAutomationModule importa um módulo para a Automação do Azure. Esse comando aceita um arquivo compactado que tenha uma extensão de nome de arquivo .zip. O arquivo contém uma pasta que inclui um arquivo que é um dos seguintes tipos:

  • Módulo do Windows PowerShell, que tem uma extensão de nome de arquivo .psm1 ou .dll
  • Manifesto do módulo do Windows PowerShell, que tem uma extensão de nome de arquivo .psd1 O nome do arquivo .zip, o nome da pasta e o nome do arquivo na pasta devem ser os mesmos. Especifique o arquivo .zip como uma URL que o serviço de automação pode acessar. Se você importar um módulo do Windows PowerShell para a Automação usando esse cmdlet ou o cmdlet Set-AzAutomationModule, a operação será assíncrona. O comando termina se a importação for bem-sucedida ou falhar. Para verificar se ele foi bem-sucedido, execute o seguinte comando: PS C:\\\> $ModuleInstance = Get-AzAutomationModule -Name ModuleName Verifique a propriedade ProvisioningState para obter um valor de Succeeded.

Exemplos

Exemplo 1: Importar um módulo

New-AzAutomationModule -AutomationAccountName "Contoso17" -Name "ContosoModule" -ContentLink "http://contosostorage.blob.core.windows.net/modules/ContosoModule.zip" -ResourceGroupName "ResourceGroup01"

Esse comando importa um módulo chamado ContosoModule para a conta de automação chamada Contoso17. O módulo é armazenado em um blob do Azure em uma conta de armazenamento chamada contosostorage e em um contêiner chamado modules.

Parâmetros

-AutomationAccountName

Especifica o nome da conta de automação para a qual esse cmdlet importa um módulo.

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

-ContentLinkUri

A url para um pacote zip de módulo

Type:Uri
Aliases:ContentLink
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

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

-Name

Especifica o nome do módulo que esse cmdlet importa.

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

-ResourceGroupName

Especifica o nome de um grupo de recursos para o qual esse cmdlet importa um módulo.

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

-RuntimeVersion

Ambiente de tempo de execução do módulo

Type:String
Accepted values:5.1, 7.2
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Uri

Saídas

Module