Azure Resource Manager テンプレートを使用した Desired State Configuration 拡張機能Desired State Configuration extension with Azure Resource Manager templates

この記事では、Desired State Configuration (DSC) 拡張機能ハンドラーの Azure Resource Manager テンプレートについて説明します。This article describes the Azure Resource Manager template for the Desired State Configuration (DSC) extension handler. 多くの例では、Azure Automation を使用してオンボードするために、RegistrationURL (String として指定) と RegistrationKey (PSCredential として指定) を使用しています。Many of the examples use RegistrationURL (provided as a String) and RegistrationKey (provided as a PSCredential to onboard with Azure Automation. それらの値の取得の詳細については、「Azure Automation State Configuration による管理のためのマシンのオンボード - セキュリティで保護された登録」を参照してください。For details about obtaining those values, see Onboarding machines for management by Azure Automation State Configuration - Secure registration.

注意

スキーマの例に若干の違いがある可能性があります。You might encounter slightly different schema examples. スキーマの変更は 2016 年 10 月 のリリースで発生しました。The change in schema occurred in the October 2016 release. 詳しくは、以前の形式からの更新に関する記事をご覧ください。For details, see Update from a previous format.

Windows VM のテンプレートの例Template example for a Windows VM

以下のスニペットは、テンプレートの Resource セクションに含まれます。The following snippet goes in the Resource section of the template. DSC 拡張機能は、既定の拡張機能プロパティを継承します。The DSC extension inherits default extension properties. 詳しくは、「VirtualMachineExtension class (VirtualMachineExtension クラス)」をご覧ください。For more information, see VirtualMachineExtension class.

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "name": "Microsoft.Powershell.DSC",
  "apiVersion": "2018-06-30",
  "location": "[parameters('location')]",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', parameters('VMName'))]"
  ],
  "properties": {
    "publisher": "Microsoft.Powershell",
    "type": "DSC",
    "typeHandlerVersion": "2.77",
    "autoUpgradeMinorVersion": true,
    "protectedSettings": {
      "Items": {
        "registrationKeyPrivate": "[listKeys(resourceId('Microsoft.Automation/automationAccounts/', parameters('automationAccountName')), '2018-06-30').Keys[0].value]"
      }
    },
    "settings": {
      "Properties": [
        {
          "Name": "RegistrationKey",
          "Value": {
            "UserName": "PLACEHOLDER_DONOTUSE",
            "Password": "PrivateSettingsRef:registrationKeyPrivate"
          },
          "TypeName": "System.Management.Automation.PSCredential"
        },
        {
          "Name": "RegistrationUrl",
          "Value": "[reference(concat('Microsoft.Automation/automationAccounts/', parameters('automationAccountName'))).registrationUrl]",
          "TypeName": "System.String"
        },
        {
          "Name": "NodeConfigurationName",
          "Value": "[parameters('nodeConfigurationName')]",
          "TypeName": "System.String"
        }
      ]
    }
  }
}

Windows 仮想マシン スケール セット用のテンプレート例Template example for Windows virtual machine scale sets

仮想マシン スケール セット ノードには、VirtualMachineProfile を備えた properties セクション、extensionProfile 属性があります。A virtual machine scale set node has a properties section that has a VirtualMachineProfile, extensionProfile attribute. [拡張機能] の下に DSC 拡張機能の詳細を追加します。Under extensions, add the details for DSC Extension.

DSC 拡張機能は、既定の拡張機能プロパティを継承します。The DSC extension inherits default extension properties. 詳しくは、「VirtualMachineScaleSetExtension class (VirtualMachineScaleSetExtension クラス)」をご覧ください。For more information, see VirtualMachineScaleSetExtension class.

"extensionProfile": {
    "extensions": [
      {
        "name": "Microsoft.Powershell.DSC",
        "properties": {
          "publisher": "Microsoft.Powershell",
          "type": "DSC",
          "typeHandlerVersion": "2.77",
          "autoUpgradeMinorVersion": true,
          "protectedSettings": {
            "Items": {
              "registrationKeyPrivate": "[listKeys(resourceId('Microsoft.Automation/automationAccounts/', parameters('automationAccountName')), '2018-06-30').Keys[0].value]"
            }
          },
          "settings": {
            "Properties": [
              {
                "Name": "RegistrationKey",
                "Value": {
                  "UserName": "PLACEHOLDER_DONOTUSE",
                  "Password": "PrivateSettingsRef:registrationKeyPrivate"
                },
                "TypeName": "System.Management.Automation.PSCredential"
              },
              {
                "Name": "RegistrationUrl",
                "Value": "[reference(concat('Microsoft.Automation/automationAccounts/', parameters('automationAccountName'))).registrationUrl]",
                "TypeName": "System.String"
              },
              {
                "Name": "NodeConfigurationName",
                "Value": "[parameters('nodeConfigurationName')]",
                "TypeName": "System.String"
              }
            ]
          }
        }
      }
    ]
  }

設定情報の詳細Detailed settings information

次のスキーマは、Resource Manager テンプレートの Azure DSC 拡張機能の settings セクションで使用します。Use the following schema in the settings section of the Azure DSC extension in a Resource Manager template.

既定の構成スクリプトで使用可能な引数の一覧については、「既定の構成スクリプト」をご覧ください。For a list of the arguments that are available for the default configuration script, see Default configuration script.

"settings": {
    "wmfVersion": "latest",
    "configuration": {
        "url": "http://validURLToConfigLocation",
        "script": "ConfigurationScript.ps1",
        "function": "ConfigurationFunction"
    },
    "configurationArguments": {
        "argument1": "Value1",
        "argument2": "Value2"
    },
    "configurationData": {
        "url": "https://foo.psd1"
    },
    "privacy": {
        "dataCollection": "enable"
    },
    "advancedOptions": {
        "downloadMappings": {
            "customWmfLocation": "http://myWMFlocation"
        }
    }
},
"protectedSettings": {
    "configurationArguments": {
        "parameterOfTypePSCredential1": {
            "userName": "UsernameValue1",
            "password": "PasswordValue1"
        },
        "parameterOfTypePSCredential2": {
            "userName": "UsernameValue2",
            "password": "PasswordValue2"
        }
    },
    "configurationUrlSasToken": "?g!bber1sht0k3n",
    "configurationDataUrlSasToken": "?dataAcC355T0k3N"
}

詳細Details

プロパティ名Property name TypeType 説明Description
settings.wmfVersionsettings.wmfVersion stringstring VM にインストールする Windows Management Framework (WMF) のバージョンを指定します。Specifies the version of Windows Management Framework (WMF) that should be installed on your VM. このプロパティを latest に設定すると、WMF の最新バージョンがインストールされます。Setting this property to latest installs the most recent version of WMF. 現在、このプロパティに設定できる値は、4.05.05.1latest のみです。Currently, the only possible values for this property are 4.0, 5.0, 5.1, and latest. これらの設定できる値は更新される可能性があります。These possible values are subject to updates. 既定値は latest です。The default value is latest.
settings.configuration.urlsettings.configuration.url stringstring DSC 構成 .zip ファイルのダウンロード元の URL の場所を指定します。Specifies the URL location from which to download your DSC configuration .zip file. 指定した URL にアクセスのための SAS トークンが必要な場合は、protectedSettings.configurationUrlSasToken プロパティに SAS トークンの値を設定します。If the URL provided requires an SAS token for access, set the protectedSettings.configurationUrlSasToken property to the value of your SAS token. settings.configuration.script または settings.configuration.function を定義する場合、このプロパティは必須です。This property is required if settings.configuration.script or settings.configuration.function are defined. これらのプロパティの値を指定しない場合、Location Configuration Manager (LCM) のメタデータを設定する既定の構成スクリプトが拡張機能から呼び出され、引数が指定されます。If no value is given for these properties, the extension calls the default configuration script to set Location Configuration Manager (LCM) metadata, and arguments should be supplied.
settings.configuration.scriptsettings.configuration.script stringstring DSC 構成の定義を含むスクリプトのファイル名を指定します。Specifies the file name of the script that contains the definition of your DSC configuration. このスクリプトは、settings.configuration.url プロパティで指定した URL からダウンロードされた .zip ファイルのルート フォルダーに含まれている必要があります。This script must be in the root folder of the .zip file that's downloaded from the URL specified by the settings.configuration.url property. settings.configuration.url または settings.configuration.script を定義する場合、このプロパティは必須です。This property is required if settings.configuration.url or settings.configuration.script are defined. これらのプロパティの値を指定しない場合、LCM のメタデータを設定する既定の構成スクリプトが拡張機能から呼び出され、引数が指定されます。If no value is given for these properties, the extension calls the default configuration script to set LCM metadata, and arguments should be supplied.
settings.configuration.functionsettings.configuration.function stringstring DSC 構成の名前を指定します。Specifies the name of your DSC configuration. 名前が指定された構成は、settings.configuration.script によって定義されたスクリプト内に含まれている必要があります。The configuration that is named must be included in the script that settings.configuration.script defines. settings.configuration.url または settings.configuration.function を定義する場合、このプロパティは必須です。This property is required if settings.configuration.url or settings.configuration.function are defined. これらのプロパティの値を指定しない場合、LCM のメタデータを設定する既定の構成スクリプトが拡張機能から呼び出され、引数が指定されます。If no value is given for these properties, the extension calls the default configuration script to set LCM metadata, and arguments should be supplied.
settings.configurationArgumentssettings.configurationArguments コレクションCollection DSC 構成に渡すパラメーターを定義します。Defines any parameters that you want to pass to your DSC configuration. このプロパティは暗号化されません。This property is not encrypted.
settings.configurationData.urlsettings.configurationData.url stringstring DSC 構成の入力として使用する構成データ (.psd1) ファイルのダウンロード元の URL を指定します。Specifies the URL from which to download your configuration data (.psd1) file to use as input for your DSC configuration. 指定した URL にアクセスのための SAS トークンが必要な場合は、protectedSettings.configurationDataUrlSasToken プロパティに SAS トークンの値を設定します。If the URL provided requires an SAS token for access, set the protectedSettings.configurationDataUrlSasToken property to the value of your SAS token.
settings.privacy.dataCollectionsettings.privacy.dataCollection stringstring テレメトリの収集を有効または無効にします。Enables or disables telemetry collection. このプロパティに指定できる値は、EnableDisable'' 、または $null のみです。The only possible values for this property are Enable, Disable, '', or $null. このプロパティを空または null にした場合は、テレメトリが有効になります。Leaving this property blank or null enables telemetry. 既定値は '' です。The default value is ''. 詳しくは、「Azure DSC extension data collection (Azure DSC 拡張機能のデータ収集)」をご覧ください。For more information, see Azure DSC extension data collection.
settings.advancedOptions.downloadMappingssettings.advancedOptions.downloadMappings コレクションCollection WMF のダウンロード元になる別の場所を定義します。Defines alternate locations from which to download WMF. 詳しくは、「Azure DSC extension 2.8 and how to map downloads of the extension dependencies to your own location (Azure DSC 拡張機能 2.8 と、拡張機能の依存関係のダウンロードを独自の場所にマップする方法)」をご覧ください。For more information, see Azure DSC extension 2.8 and how to map downloads of the extension dependencies to your own location.
protectedSettings.configurationArgumentsprotectedSettings.configurationArguments コレクションCollection DSC 構成に渡すパラメーターを定義します。Defines any parameters that you want to pass to your DSC configuration. このプロパティは暗号化されます。This property is encrypted.
protectedSettings.configurationUrlSasTokenprotectedSettings.configurationUrlSasToken stringstring settings.configuration.url で定義された URL へのアクセスに使用する SAS トークンを指定します。Specifies the SAS token to use to access the URL that settings.configuration.url defines. このプロパティは暗号化されます。This property is encrypted.
protectedSettings.configurationDataUrlSasTokenprotectedSettings.configurationDataUrlSasToken stringstring settings.configurationData.url で定義された URL へのアクセスに使用する SAS トークンを指定します。Specifies the SAS token to use to access the URL that settings.configurationData.url defines. このプロパティは暗号化されます。This property is encrypted.

既定の構成スクリプトDefault configuration script

次の値について詳しくは、ローカル構成マネージャーの基本設定に関するページをご覧ください。For more information about the following values, see Local Configuration Manager basic settings. DSC 拡張機能の既定の構成スクリプトは、次の表に記載されている LCM プロパティの構成にのみ使用できます。You can use the DSC extension default configuration script to configure only the LCM properties that are listed in the following table.

プロパティ名Property name TypeType 説明Description
protectedSettings.configurationArguments.RegistrationKeyprotectedSettings.configurationArguments.RegistrationKey PSCredentialPSCredential 必須のプロパティです。Required property. Azure Automation サービスに登録するためにノードで使用するキーを、PowerShell 資格情報オブジェクトのパスワードとして指定します。Specifies the key that's used for a node to register with the Azure Automation service as the password of a PowerShell credential object. この値は、Automation アカウントに対して listkeys メソッドを使用することで、自動的に検出できます。This value can be automatically discovered by using the listkeys method against the Automation account. を参照してください。See the example.
settings.configurationArguments.RegistrationUrlsettings.configurationArguments.RegistrationUrl stringstring 必須のプロパティです。Required property. ノードが登録を試みる Automation エンドポイントの URL を指定します。Specifies the URL of the Automation endpoint where the node attempts to register. この値は、Automation アカウントに対して reference メソッドを使用することで、自動的に検出できます。This value can be automatically discovered by using the reference method against the Automation account.
settings.configurationArguments.NodeConfigurationNamesettings.configurationArguments.NodeConfigurationName stringstring 必須のプロパティです。Required property. ノードに割り当てる Automation アカウントのノード構成を指定します。Specifies the node configuration in the Automation account to assign to the node.
settings.configurationArguments.ConfigurationModesettings.configurationArguments.ConfigurationMode stringstring LCM のモードを指定します。Specifies the mode for LCM. 有効なオプションには、ApplyOnlyApplyandMonitor、および ApplyandAutoCorrect があります。Valid options include ApplyOnly, ApplyandMonitor, and ApplyandAutoCorrect. 既定値は ApplyandMonitor です。The default value is ApplyandMonitor.
settings.configurationArguments.RefreshFrequencyMinssettings.configurationArguments.RefreshFrequencyMins uint32uint32 LCM が Automation アカウントを使用して更新プログラムの確認を試みる頻度を指定します。Specifies how often LCM attempts to check with the Automation account for updates. 既定値は 30 です。Default value is 30. 最小値は 15 です。Minimum value is 15.
settings.configurationArguments.ConfigurationModeFrequencyMinssettings.configurationArguments.ConfigurationModeFrequencyMins uint32uint32 LCM が現在の構成を検証する頻度を指定します。Specifies how often LCM validates the current configuration. 既定値は 15 です。Default value is 15. 最小値は 15 です。Minimum value is 15.
settings.configurationArguments.RebootNodeIfNeededsettings.configurationArguments.RebootNodeIfNeeded booleanboolean DSC 操作で要求した場合に、ノードが自動的に再起動されてよいかどうかを指定します。Specifies whether a node can be automatically rebooted if a DSC operation requests it. 既定値は false です。Default value is false.
settings.configurationArguments.ActionAfterRebootsettings.configurationArguments.ActionAfterReboot stringstring 構成を適用したときの再起動後の動作を指定します。Specifies what happens after a reboot when applying a configuration. 有効なオプションは、ContinueConfigurationStopConfiguration です。Valid options are ContinueConfiguration and StopConfiguration. 既定値は ContinueConfiguration です。Default value is ContinueConfiguration.
settings.configurationArguments.AllowModuleOverwritesettings.configurationArguments.AllowModuleOverwrite booleanboolean LCM がノード上の既存のモジュールを上書きするかどうかを指定します。Specifies whether LCM overwrites existing modules on the node. 既定値は false です。Default value is false.

settings と protectedSettingssettings vs. protectedSettings

すべての設定は、VM の設定テキスト ファイルに保存されます。All settings are saved in a settings text file on the VM. settings の下に記載されているプロパティはパブリック プロパティです。Properties listed under settings are public properties. パブリック プロパティは、設定のテキスト ファイル内で暗号化されません。Public properties aren't encrypted in the settings text file. protectedSettings の下に記載されたプロパティは証明書で暗号化されるため、VM 上の設定ファイルにプレーンテキストで表示されません。Properties listed under protectedSettings are encrypted with a certificate and are not shown in plain text in the settings file on the VM.

構成に資格情報が必要な場合は、protectedSettings に資格情報を含めることができます。If the configuration needs credentials, you can include the credentials in protectedSettings:

"protectedSettings": {
    "configurationArguments": {
        "parameterOfTypePSCredential1": {
               "userName": "UsernameValue1",
               "password": "PasswordValue1"
        }
    }
}

構成スクリプトの例Example configuration script

次の例は、DSC 拡張機能の既定の動作を示したものです (LCM にメタデータの設定を提供し、Automation DSC サービスに登録します)。The following example shows the default behavior for the DSC extension, which is to provide metadata settings to LCM and register with the Automation DSC service. 構成引数は必須です。Configuration arguments are required. 構成引数は、LCM のメタデータを設定するために既定の構成スクリプトに渡されます。Configuration arguments are passed to the default configuration script to set LCM metadata.

"settings": {
    "configurationArguments": {
        "RegistrationUrl" : "[parameters('registrationUrl1')]",
        "NodeConfigurationName" : "nodeConfigurationNameValue1"
    }
},
"protectedSettings": {
    "configurationArguments": {
        "RegistrationKey": {
            "userName": "NOT_USED",
            "Password": "registrationKey"
        }
    }
}

Azure Storage での構成スクリプトの使用例Example using the configuration script in Azure Storage

次の例は、DSC 拡張機能ハンドラーの概要に関する記事から引用したものです。The following example is from the DSC extension handler overview. この例では、コマンドレットの代わりに Resource Manager テンプレートを使用して拡張機能をデプロイします。This example uses Resource Manager templates instead of cmdlets to deploy the extension. IisInstall.ps1 の構成を保存し、.zip ファイル (例: iisinstall.zip) 内に配置してから、アクセス可能な URL にファイルをアップロードします。Save the IisInstall.ps1 configuration, place it in a .zip file (example: iisinstall.zip), and then upload the file in an accessible URL. この例では、Azure Blob Storage を使用しますが、.zip ファイルを任意の場所からダウンロードすることもできます。This example uses Azure Blob storage, but you can download .zip files from any arbitrary location.

Resource Manager テンプレートでは、次のコードにより、正しいファイルをダウンロードして適切な PowerShell 関数を実行するように VM に対して指示をします。In the Resource Manager template, the following code instructs the VM to download the correct file, and then run the appropriate PowerShell function:

"settings": {
    "configuration": {
        "url": "https://demo.blob.core.windows.net/iisinstall.zip",
        "script": "IisInstall.ps1",
        "function": "IISInstall"
    }
},
"protectedSettings": {
    "configurationUrlSasToken": "odLPL/U1p9lvcnp..."
}

参照されている Azure Automation 登録の値の使用例Example using referenced Azure Automation registration values

次の例では、Azure Automation アカウントのプロパティを参照し、listkeys メソッドを使用して主キー (0) を取得することで、RegistrationUrlRegistrationKey を取得します。The following example gets the RegistrationUrl and RegistrationKey by referencing the Azure Automation account properties and using the listkeys method to retrieve the Primary Key (0). この例では、パラメーター automationAccountName および NodeConfigName がテンプレートに指定されています。In this example, the parameters automationAccountName and NodeConfigName were provided to the template.

"settings": {
    "RegistrationUrl" : "[reference(concat('Microsoft.Automation/automationAccounts/', parameters('automationAccountName'))).registrationUrl]",
    "NodeConfigurationName" : "[parameters('NodeConfigName')]"
},
"protectedSettings": {
    "configurationArguments": {
        "RegistrationKey": {
            "userName": "NOT_USED",
            "Password": "[listKeys(resourceId('Microsoft.Automation/automationAccounts/', parameters('automationAccountName')), '2018-01-15').Keys[0].value]"
        }
    }
}

以前の形式からの更新Update from a previous format

拡張機能の以前の形式の設定 (ModulesUrlModuleSourceModuleVersionConfigurationFunctionSasToken、または Properties の各パブリック プロパティを含むもの) は、自動的に拡張機能の現在の形式に対応します。Any settings in a previous format of the extension (and which have the public properties ModulesUrl, ModuleSource, ModuleVersion, ConfigurationFunction, SasToken, or Properties) automatically adapt to the current format of the extension. これらは以前と同じように動作します。They run just as they did before.

次のスキーマは、以前の設定スキーマの例を示したものです。The following schema shows what the previous settings schema looked like:

"settings": {
    "WMFVersion": "latest",
    "ModulesUrl": "https://UrlToZipContainingConfigurationScript.ps1.zip",
    "SasToken": "SAS Token if ModulesUrl points to private Azure Blob Storage",
    "ConfigurationFunction": "ConfigurationScript.ps1\\ConfigurationFunction",
    "Properties": {
        "ParameterToConfigurationFunction1": "Value1",
        "ParameterToConfigurationFunction2": "Value2",
        "ParameterOfTypePSCredential1": {
            "UserName": "UsernameValue1",
            "Password": "PrivateSettingsRef:Key1"
        },
        "ParameterOfTypePSCredential2": {
            "UserName": "UsernameValue2",
            "Password": "PrivateSettingsRef:Key2"
        }
    }
},
"protectedSettings": {
    "Items": {
        "Key1": "PasswordValue1",
        "Key2": "PasswordValue2"
    },
    "DataBlobUri": "https://UrlToConfigurationDataWithOptionalSasToken.psd1"
}

以前の形式と現在の形式の対応関係を次に示します。Here's how the previous format adapts to the current format:

現在のプロパティ名Current Property name 対応する以前のスキーマPrevious schema equivalent
settings.wmfVersionsettings.wmfVersion settings.wmfVersionsettings.WMFVersion
settings.configuration.urlsettings.configuration.url settings.ModulesUrlsettings.ModulesUrl
settings.configuration.scriptsettings.configuration.script settings.ConfigurationFunction の最初の部分 (\\ の前)First part of settings.ConfigurationFunction (before \\)
settings.configuration.functionsettings.configuration.function settings.ConfigurationFunction の 2 番目の部分 (\\ の後)Second part of settings.ConfigurationFunction (after \\)
settings.configuration.module.namesettings.configuration.module.name settings.ModuleSourcesettings.ModuleSource
settings.configuration.module.versionsettings.configuration.module.version settings.ModuleVersionsettings.ModuleVersion
settings.configurationArgumentssettings.configurationArguments settings.Propertiessettings.Properties
settings.configurationData.urlsettings.configurationData.url protectedSettings.DataBlobUri (SAS トークンを使用しない)protectedSettings.DataBlobUri (without SAS token)
settings.privacy.dataCollectionsettings.privacy.dataCollection settings.Privacy.dataCollectionsettings.Privacy.dataCollection
settings.advancedOptions.downloadMappingssettings.advancedOptions.downloadMappings settings.advancedOptions.downloadMappingssettings.AdvancedOptions.DownloadMappings
protectedSettings.configurationArgumentsprotectedSettings.configurationArguments protectedSettings.PropertiesprotectedSettings.Properties
protectedSettings.configurationUrlSasTokenprotectedSettings.configurationUrlSasToken settings.SasTokensettings.SasToken
protectedSettings.configurationDataUrlSasTokenprotectedSettings.configurationDataUrlSasToken protectedSettings.DataBlobUri の SAS トークンSAS token from protectedSettings.DataBlobUri

トラブルシューティングTroubleshooting

直面する可能性のあるいくつかのエラーとそのエラーの修正方法について説明します。Here are some of the errors you might run into and how you can fix them.

無効な値Invalid values

"Privacy.dataCollection is '{0}'."Privacy.dataCollection is '{0}'. The only possible values are '', 'Enable', and 'Disable' (Privacy.dataCollection は '{0}' です。指定できる値は ''、'Enable'、および 'Disable' のみです)"The only possible values are '', 'Enable', and 'Disable'". "WmfVersion is '{0}'."WmfVersion is '{0}'. Only possible values are … and 'latest' (WmfVersion は '{0}' です。指定できる値は …Only possible values are … および 'latest' のみです)"and 'latest'".

問題点:指定した値が許可されていません。Problem: A provided value is not allowed.

解決策:無効な値を有効な値に変更してください。Solution: Change the invalid value to a valid value. 詳しくは、「詳細」の表をご覧ください。For more information, see the table in Details.

無効な URLInvalid URL

"ConfigurationData.url is '{0}'."ConfigurationData.url is '{0}'. This is not a valid URL. (Configuration.url は '{0}' です。これは有効な URL ではありません。)" "DataBlobUri is '{0}'.This is not a valid URL" "DataBlobUri is '{0}'. これは有効な URL ではありません)" "Configuration.url is '{0}'.This is not a valid URL (Configuration.url は '{0}' です。This is not a valid URL" "Configuration.url is '{0}'. これは有効な URL ではありません)"This is not a valid URL"

問題点:指定した URL が無効です。Problem: A provided URL is not valid.

解決策:指定した URL すべてを確認してください。Solution: Check all your provided URLs. 拡張機能がリモート マシンにアクセスできるように、すべての URL が有効な場所に解決されていることを確認します。Ensure that all URLs resolve to valid locations that the extension can access on the remote machine.

無効な RegistrationKey の型Invalid RegistrationKey type

"Invalid type for parameter RegistrationKey of type PSCredential. (型 PSCredential のパラメーター RegistrationKey の無効な型。)""Invalid type for parameter RegistrationKey of type PSCredential."

問題点:protectedSettings.configurationArguments の RegistrationKey の値は、PSCredential 以外の型としては指定できません。Problem: The RegistrationKey value in protectedSettings.configurationArguments cannot be provided as any type other than a PSCredential.

解決策:RegistrationKey の protectedSettings.configurationArguments エントリを、次の形式を使用して PSCredential 型に変更してください。Solution: Change your protectedSettings.configurationArguments entry for RegistrationKey to a PSCredential type using the following format:

"configurationArguments": {
    "RegistrationKey": {
        "userName": "NOT_USED",
        "Password": "RegistrationKey"
    }
}

無効な ConfigurationArgument の型Invalid ConfigurationArgument type

"Invalid configurationArguments type {0} (無効な configurationArguments の型 {0})""Invalid configurationArguments type {0}"

問題点:ConfigurationArguments プロパティが ハッシュ テーブル オブジェクトに解決できません。Problem: The ConfigurationArguments property can't resolve to a Hash table object.

解決策:ConfigurationArguments プロパティを ハッシュ テーブル にしてください。Solution: Make your ConfigurationArguments property a Hash table. 前の例に示されている形式に従います。Follow the format provided in the preceding examples. 引用符、コンマ、および中かっこに注意します。Watch for quotes, commas, and braces.

ConfigurationArguments の重複Duplicate ConfigurationArguments

"Found duplicate arguments '{0}' in both public and protected configurationArguments (パブリックと保護対象の両方の configurationArguments で重複する引数 '{0}' が見つかりました)""Found duplicate arguments '{0}' in both public and protected configurationArguments"

問題点:パブリック設定の ConfigurationArguments と保護された設定の ConfigurationArguments に同じ名前のプロパティが含まれています。Problem: The ConfigurationArguments in public settings and the ConfigurationArguments in protected settings have properties with the same name.

解決策:重複するプロパティのいずれかを削除してください。Solution: Remove one of the duplicate properties.

不足しているプロパティMissing properties

"settings.Configuration.function requires that settings.configuration.url or settings.configuration.module is specified (settings.Configuration.function には、settings.configuration.url または settings.configuration.module の指定が必要です)""settings.Configuration.function requires that settings.configuration.url or settings.configuration.module is specified"

"settings.Configuration.url requires that settings.configuration.script is specified (settings.Configuration.url には settings.configuration.script の指定が必要です)""settings.Configuration.url requires that settings.configuration.script is specified"

"settings.Configuration.script requires that settings.configuration.url is specified (settings.Configuration.script には settings.configuration.url の指定が必要です)""settings.Configuration.script requires that settings.configuration.url is specified"

"settings.Configuration.url requires that settings.configuration.function is specified (settings.Configuration.url には settings.configuration.function の指定が必要です)""settings.Configuration.url requires that settings.configuration.function is specified"

"protectedSettings.ConfigurationUrlSasToken requires that settings.configuration.url is specified (protectedSettings.ConfigurationUrlSasToken には settings.configuration.url の指定が必要です)""protectedSettings.ConfigurationUrlSasToken requires that settings.configuration.url is specified"

"protectedSettings.ConfigurationDataUrlSasToken requires that settings.configurationData.url is specified (protectedSettings.ConfigurationDataUrlSasToken には settings.configurationData.url の指定が必要です)""protectedSettings.ConfigurationDataUrlSasToken requires that settings.configurationData.url is specified"

問題点:定義したプロパティには、不足している別のプロパティが必要です。Problem: A defined property needs another property, which is missing.

解決策:Solutions:

  • 不足しているプロパティを指定します。Provide the missing property.
  • 不足しているプロパティを必要とするプロパティを削除します。Remove the property that needs the missing property.

次のステップNext steps