New-AzRelayHybridConnection
サービス ハイブリッド接続を作成または更新します。 この操作はべき等です。
構文
New-AzRelayHybridConnection
-Name <String>
-Namespace <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-RequiresClientAuthorization]
[-UserMetadata <String>]
[-DefaultProfile <PSObject>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
New-AzRelayHybridConnection
-Name <String>
-Namespace <String>
-ResourceGroupName <String>
-InputObject <IHybridConnection>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
説明
サービス ハイブリッド接続を作成または更新します。 この操作はべき等です。
例
例 1: 指定した Relay 名前空間にハイブリッド接続を作成する
New-AzRelayHybridConnection -ResourceGroupName lucas-relay-rg -Namespace namespace-pwsh01 -Name connection-01 -UserMetadata "test 01" | Format-List
CreatedAt : 1/1/0001 12:00:00 AM
Id : /subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourceGroups/lucas-relay-rg/providers/Microso
ft.Relay/namespaces/namespace-pwsh01/hybridconnections/connection-01
ListenerCount : 0
Location : eastus
Name : connection-01
RequiresClientAuthorization : True
ResourceGroupName : lucas-relay-rg
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
Type : Microsoft.Relay/namespaces/hybridconnections
UpdatedAt : 1/1/0001 12:00:00 AM
UserMetadata :
このコマンドレットは、指定された Relay 名前空間にハイブリッド接続を作成します。
例 2: 既存のハイブリッド接続をパラメーターとして使用して新しいハイブリッド接続を作成する
$connection = Get-AzRelayHybridConnection -ResourceGroupName lucas-relay-rg -Namespace namespace-pwsh01 -Name connection-01
$connection.RequiresClientAuthorization = $false
New-AzRelayHybridConnection -ResourceGroupName lucas-relay-rg -Namespace namespace-pwsh01 -Name connection-02 -InputObject $connection | Format-List
CreatedAt : 12/20/2022 9:13:18 AM
Id : /subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourceGroups/lucas-relay-rg/providers/Microsoft.Relay/namespaces/namespa
ce-pwsh01/hybridconnections/connection-02
ListenerCount : 0
Location : eastus
Name : connection-02
RequiresClientAuthorization : False
ResourceGroupName : lucas-relay-rg
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
Type : Microsoft.Relay/namespaces/hybridconnections
UpdatedAt : 12/20/2022 9:13:18 AM
UserMetadata : test 03
このコマンドレットは、既存のハイブリッド接続をパラメーターとして使用して、新しいハイブリッド接続を作成します。
例 3: 既存のハイブリッド接続を更新する
$connection = Get-AzRelayHybridConnection -ResourceGroupName lucas-relay-rg -Namespace namespace-pwsh01 -Name connection-02
$connection.UserMetadata = "TestHybirdConnection2"
New-AzRelayHybridConnection -ResourceGroupName lucas-relay-rg -Namespace namespace-pwsh01 -Name connection-02 -InputObject $connection | Format-List
CreatedAt : 1/1/0001 12:00:00 AM
Id : /subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourceGroups/lucas-relay-rg/providers/Microsoft.Relay/namespaces/namespa
ce-pwsh01/hybridconnections/connection-02
ListenerCount : 0
Location : eastus
Name : connection-02
RequiresClientAuthorization : False
ResourceGroupName : lucas-relay-rg
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
Type : Microsoft.Relay/namespaces/hybridconnections
UpdatedAt : 1/1/0001 12:00:00 AM
UserMetadata : TestHybirdConnection2
このコマンドレットは、既存のハイブリッド接続を更新します。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。
Type: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
ハイブリッド接続リソースの説明。 構築するには、INPUTOBJECT プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。
Type: | IHybridConnection |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
ハイブリッド接続名。
Type: | String |
Aliases: | HybridConnectionName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Namespace
名前空間名
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiresClientAuthorization
このハイブリッド接続にクライアント承認が必要な場合は true を返します。それ以外の場合は false。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Azure サブスクリプション内のリソース グループの名前。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、全ての修理依頼についてURI の一部を生じさせます。
Type: | String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserMetadata
usermetadata は、ハイブリッド接続エンドポイントのユーザー定義文字列データを格納するためのプレースホルダーです。 たとえば、チームとその連絡先情報の一覧などの説明データを格納するために使用できます。 また、ユーザー定義の構成設定を格納することもできます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
出力
メモ
別名
複合パラメーターのプロパティ
以下で説明するパラメーターを作成するには、適切なプロパティを含むハッシュ テーブルを作成します。 ハッシュ テーブルの詳細については、Get-Help about_Hash_Tablesを実行します。
INPUTOBJECT <IHybridConnection>
: ハイブリッド接続リソースの説明。
[RequiresClientAuthorization <Boolean?>]
: このハイブリッド接続にクライアント承認が必要な場合は true を返します。それ以外の場合は false。[SystemDataCreatedAt <DateTime?>]
: リソース作成のタイムスタンプ (UTC)。[SystemDataCreatedBy <String>]
: リソースを作成した ID。[SystemDataCreatedByType <CreatedByType?>]
: リソースを作成した ID の種類。[SystemDataLastModifiedAt <DateTime?>]
: リソースの最終変更のタイムスタンプ (UTC)[SystemDataLastModifiedBy <String>]
: リソースを最後に変更した ID。[SystemDataLastModifiedByType <CreatedByType?>]
: リソースを最後に変更した ID の種類。[UserMetadata <String>]
: usermetadata は、ハイブリッド接続エンドポイントのユーザー定義文字列データを格納するためのプレースホルダーです。 たとえば、チームとその連絡先情報の一覧などの説明データを格納するために使用できます。 また、ユーザー定義の構成設定を格納することもできます。
Azure PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示