New-AzAutomationModule
語法
Default (預設值)
New-AzAutomationModule
[-Name] <String>
[-ContentLinkUri] <Uri>
[-RuntimeVersion <String>]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
New-AzAutomationModule Cmdlet 會將模組匯入 Azure 自動化。
此命令接受副檔名 .zip 的壓縮檔案。
檔案包含一個資料夾，其中包含下列其中一種類型的檔案：
- Windows PowerShell 模組，其副檔名為 .psm1 或 .dll
- 具有 .psd1 副檔名的 Windows PowerShell 模組資訊清單 .zip 檔案名稱、資料夾名稱和資料夾中的檔案名稱必須相同。
將 .zip 檔案指定為自動化服務可以存取的 URL。
如果您使用此 Cmdlet 或 Set-AzAutomationModule Cmdlet 將 Windows PowerShell 模組匯入自動化，則作業是非同步的。
無論匯入成功或失敗，指令都會完成。
若要檢查是否成功，請執行下列命令：
PS C:\\\> $ModuleInstance = Get-AzAutomationModule -Name ModuleName 檢查 ProvisioningState 屬性是否有 Succeeded 值。
範例
範例 1：匯入模組
New-AzAutomationModule -AutomationAccountName "Contoso17" -Name "ContosoModule" -ContentLink "http://contosostorage.blob.core.windows.net/modules/ContosoModule.zip" -ResourceGroupName "ResourceGroup01"
此命令會將名為 ContosoModule 的模組匯入名為 Contoso17 的自動化帳戶。
模組會儲存在名為 contosostorage 的儲存體帳戶和名為 modules 的容器中的 Azure Blob 中。
參數
-AutomationAccountName
指定此 Cmdlet 匯入其模組的自動化帳戶名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ContentLinkUri
模組 zip 套件的 URL
參數屬性
| 類型: | Uri
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 內容連結 |
參數集
(All)
| Position: | 3 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-DefaultProfile
用來與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
指定此 Cmdlet 匯入的模組名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 2 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ResourceGroupName
指定此 Cmdlet 匯入模組的資源群組名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-RuntimeVersion
模組的運行時環境
參數屬性
| 類型: | String
|
| 預設值: | None |
| 接受的值: | 5.1, 7.2 |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸出
