New-AzureRmApiManagementProperty
新しいプロパティを作成します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
New-AzureRmApiManagementProperty
-Context <PsApiManagementContext>
[-PropertyId <String>]
-Name <String>
-Value <String>
[-Secret]
[-Tag <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
New-AzureRmApiManagementProperty コマンドレットは、Azure API Management プロパティを作成します。
例
例 1: タグを含むプロパティを作成する
PS C:\>$apimContext = New-AzureRmApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
PS C:\>$Tags = 'sdk', 'powershell'
PS C:\> New-AzureRmApiManagementProperty -Context $apimContext -PropertyId "Property11" -Name "Property Name" -Value "Property Value" -Tags $Tags
最初のコマンドは、$Tags変数に 2 つの値を割り当てます。 2 番目のコマンドは、プロパティを作成し、$Tags内の文字列をプロパティのタグとして割り当てます。
例 2: シークレット値を持つプロパティを作成する
PS C:\>$apimContext = New-AzureRmApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
PS C:\>New-AzureRmApiManagementProperty -Context $apimContext -PropertyId "Property12" -Name "Secret Property -Value "Secret Property Value" -Secret
このコマンドは、 暗号化された値を持つプロパティ を作成します。
パラメーター
-Context
PsApiManagementContext オブジェクトを指定します。
型: | PsApiManagementContext |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
このコマンドレットで作成するプロパティの名前を指定します。 最大長は 100 文字です。 名前には、文字、数字、ピリオド、ダッシュ、およびアンダースコア文字のみが含まれます。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PropertyId
プロパティの ID を指定します。 最大 256 文字までです。 ID を指定しない場合、このコマンドレットは ID を生成します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Secret
プロパティ値がシークレットであり、暗号化する必要があることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Tag
プロパティに関連付けるタグ。 このパラメーターは省略可能です。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Value
プロパティの値を指定します。 この値には、ポリシー式を含めることができます。 最大長は 1,000 文字です。 値を空にしたり、空白のみで構成したりすることはできません。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
String[]