New-AzBastionShareableLink
Bastion の共有可能リンク機能を使用すると、ユーザーは、Azure portal にアクセスせずに、Azure Bastion を使用してターゲット リソース (仮想マシンまたは仮想マシン スケール セット) に接続できます。
構文
New-AzBastionShareableLink
-ResourceGroupName <String>
-Name <String>
-TargetVmId <System.Collections.Generic.List`1[System.String]>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzBastionShareableLink
-ResourceId <String>
-TargetVmId <System.Collections.Generic.List`1[System.String]>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzBastionShareableLink
-InputObject <PSBastion>
-TargetVmId <System.Collections.Generic.List`1[System.String]>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
要求で指定されたすべての VM の Bastion 共有可能リンクを作成します。
例
例 1
$vm = Get-AzVM -ResourceGroupName $RgName -Name $vmName
New-AzBastionShareableLink -ResourceGroupName $RgName -Name $bastionName -TargetVmId $vm.Id
{
"vm": {
"id": "/subscriptions/subid/resourceGroups/rgx/providers/Microsoft.Compute/virtualMachines/vm1"
},
"bsl": "http://bst-bastionhostid.bastion.com/api/shareable-url/tokenvm1",
"createdAt": "2019-10-18T12:00:00.0000Z"
}
例 2
$vm1 = Get-AzVM -ResourceGroupName $RgName -Name $vmName1
$vm2 = Get-AzVM -ResourceGroupName $RgName -Name $vmName2
$bastion = Get-AzBastion -ResourceGroupName $RgName -Name $bastionName
New-AzBastionShareableLink -InputObject $bastion -TargetVmId $vm1.Id, $vm2.Id
{
"vm": {
"id": "/subscriptions/subid/resourceGroups/rgx/providers/Microsoft.Compute/virtualMachines/vm1"
},
"bsl": "http://bst-bastionhostid.bastion.com/api/shareable-url/tokenvm1",
"createdAt": "2019-10-18T12:00:00.0000Z"
},
{
"vm": {
"id": "/subscriptions/subid/resourceGroups/rgx/providers/Microsoft.Compute/virtualMachines/vm2"
},
"bsl": "http://bst-bastionhostid.bastion.com/api/shareable-url/tokenvm2",
"createdAt": "2019-10-17T12:00:00.0000Z"
}
Bastion リソース上の指定された VM の共有可能なリンクを作成します。
パラメーター
-AsJob
バックグラウンドでコマンドレットを実行する
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
型: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
Bastion オブジェクト
型: | PSBastion |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
Bastion リソース名
型: | String |
Aliases: | ResourceName, BastionName |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
Bastion リソースが存在するリソース グループ名
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ResourceId
Bastion リソース ID
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TargetVmId
Bastion 共有可能リンクの生成を必要とする VM の ID
型: | List<T>[String] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
List<T>[[System.String, System.Private.CoreLib, Version=8.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
出力
List<T>[[Microsoft.Azure.Commands.Network.Models.Bastion.PSBastionShareableLink, Microsoft.Azure.PowerShell.Cmdlets.Network, Version=7.5.0.0, Culture=neutral, PublicKeyToken=null]]
関連リンク
Azure PowerShell