Set-AzureStorSimpleDevice
デバイスのデバイス構成を変更します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される PowerShell モジュールです。
構文
Set-AzureStorSimpleDevice
-DeviceName <String>
[-NewName <String>]
[-TimeZone <TimeZoneInfo>]
[-SecondaryDnsServer <String>]
[-StorSimpleNetworkConfig <NetworkConfig[]>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Set-AzureStorSimpleDevice
-DeviceId <String>
[-NewName <String>]
[-TimeZone <TimeZoneInfo>]
[-SecondaryDnsServer <String>]
[-StorSimpleNetworkConfig <NetworkConfig[]>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
説明
Set-AzureStorSimpleDevice コマンドレットは、デバイスのデバイス構成を変更します。 デバイスを初めて設定する場合は、TimeZone、SecondaryDnsServer、StorSimpleNetworkConfig パラメーターを指定する必要があります。 コントローラー 0 とコントローラー 1 と IP アドレスを使用する Data0 のネットワーク構成を含める必要があります。 デバイスを初めて構成するには、少なくとも 1 つのインターネット SCSI (ISCSI) 対応ネットワーク インターフェイスが必要です。
例
例 1: デバイスの構成を変更する
PS C:\>$NetworkConfigData0 = New-AzureStorSimpleNetworkConfig -InterfaceAlias Data0 -EnableIscsi $True -Controller0IPv4Address "10.67.64.48" -Controller1IPv4Address "10.67.64.49"
PS C:\> $TimeZoneInfo = [System.TimeZoneInfo]::GetSystemTimeZones() | where { $_.Id -eq "Pacific Standard Time" }
PS C:\> $OnlineDevice = @(Get-AzureStorSimpleDevice | Where { $_.Status -eq "Online"})[0]
PS C:\> $UpdatedDetails = Set-AzureStorSimpleDevice -DeviceId $OnlineDevice.DeviceId -NewName "Device22" -TimeZone $TimeZoneInfo -SecondaryDnsServer 10.8.8.8 -StorSimpleNetworkConfig $NetworkConfigData0
VERBOSE: ClientRequestId: 0f163163-5ad0-4635-a7b5-870d47297f66_PS
VERBOSE: Successfully created a StorSimple Network Configuration for interface Data0
VERBOSE: ClientRequestId: 552e4a6c-7006-4015-a20b-9def6428a85e_PS
VERBOSE: ClientRequestId: f31cc84c-bc8a-404a-9da6-4670a7999e75_PS
VERBOSE: 1 StorSimple device found!
VERBOSE: ClientRequestId: 545bc1a9-3c1b-4e50-89a6-9678aefe79e5_PS
VERBOSE: ClientRequestId: f114ad08-47f5-4fb8-8a01-1ea7f1ed1b98_PS
VERBOSE: About to configure the device : Device22 !
VERBOSE: ClientRequestId: 6afe7927-1c19-48d3-ac22-68148fd056b8_PS
VERBOSE: The task created for your Setup operation has completed successfully.
VERBOSE: ClientRequestId: 467c142c-90da-4d75-82a4-c114afce953d_PS
VERBOSE: Successfully updated configuration for device Device22 with id 865e68f6-1e71-47b6-80d5-15d3a23bd2b0
最初のコマンドは、Data0 インターフェイスのネットワーク構成を作成します。 このコマンドは、 Controller0IPv4Address、 Controller1IPv4Address、および EnableIscsi パラメーターを指定します。 このコマンドは、結果を $NetworkConfigData 0 変数に格納します。
2 番目の コマンドでは、System.TimeZoneInfo .NET クラスと標準構文を使用して Pacific Standard タイム ゾーンを取得し、そのオブジェクトを$TimeZoneInfo変数に格納します。
3 番目の コマンドでは、Get-AzureStorSimpleDevice コマンドレットと Where-Object コア コマンドレットを使用してオンラインの StorSimple デバイスを取得し、$OnlineDevice変数に格納します。
最後のコマンドは、指定されたデバイス ID を持つデバイスの構成を変更します。 このコマンドは、現在のコマンドレットが最初のコマンドで作成した構成オブジェクトを使用します。 このコマンドは、$TimeZoneInfoに格納されているタイム ゾーンを使用します。
例 2: 構成オブジェクトをパイプしてデバイスを変更する
PS C:\>$TimeZoneInfo = [System.TimeZoneInfo]::GetSystemTimeZones() | where { $_.Id -eq "Pacific Standard Time" }
PS C:\> $OnlineDevice = @(Get-AzureStorSimpleDevice | Where { $_.Status -eq "Online"})[0]
PS C:\> $UpdatedDetails = New-AzureStorSimpleNetworkConfig -InterfaceAlias Data0 -EnableIscsi $True -Controller0IPv4Address "10.67.64.48" -Controller1IPv4Address "10.67.64.49" | Set-AzureStorSimpleDevice -DeviceId $OnlineDevice.DeviceId -NewName "Device22" -TimeZone $TimeZoneInfo -SecondaryDnsServer 10.8.8.8
VERBOSE: ClientRequestId: fa2f5000-169c-4feb-abbf-23f4b5c837fa_PS
VERBOSE: Successfully created a StorSimple Network Configuration for interface Data0
VERBOSE: ClientRequestId: fae6a491-919c-44b2-93e0-0c51f202c24b_PS
VERBOSE: ClientRequestId: e1803427-a097-4d58-ab7d-14a4c39fd768_PS
VERBOSE: 1 StorSimple device found!
VERBOSE: ClientRequestId: 9e796c3d-3100-46ab-9a09-0e10c73a296f_PS
VERBOSE: ClientRequestId: 5b4cad96-31f4-4d07-a278-df5af3e06ad4_PS
VERBOSE: About to configure the device : Device22 !
VERBOSE: ClientRequestId: 9061f7df-144f-4f30-858c-045d882ca392_PS
VERBOSE: The task created for your Setup operation has completed successfully.
VERBOSE: ClientRequestId: 2ed2fa9b-8459-4cd6-9a61-5fc25ced2815_PS
VERBOSE: Successfully updated configuration for device Device22 with id 865e68f6-1e71-47b6-80d5-15d3a23bd2b0
この例では、最初の例と同じ構成更新を行います。ただし、最終的なコマンドがパイプライン演算子を使用して現在のコマンドレットにネットワーク構成オブジェクトを渡す点が異なります。
例 3: デバイスを変更するためにタイム ゾーン オブジェクトをパイプする
PS C:\>$NetworkConfigData0 = New-AzureStorSimpleNetworkConfig -InterfaceAlias Data0 -EnableIscsi $True -Controller0IPv4Address "10.67.64.48" -Controller1IPv4Address "10.67.64.49"
PS C:\> $OnlineDevice = @(Get-AzureStorSimpleDevice | Where { $_.Status -eq "Online"})[0]
PS C:\> $UpdatedDetails = [System.TimeZoneInfo]::GetSystemTimeZones() | where { $_.Id -eq "Pacific Standard Time" } | Set-AzureStorSimpleDevice -DeviceId $OnlineDevice.DeviceId -NewName "Device22" -SecondaryDnsServer 10.8.8.8 -StorSimpleNetworkConfig $NetworkConfigData0
VERBOSE: ClientRequestId: cfc3f3c7-a8b6-462b-96f4-124050b736fe_PS
VERBOSE: Successfully created a StorSimple Network Configuration for interface Data0
VERBOSE: ClientRequestId: 6017b76f-a771-4bf8-901e-14876e0f9962_PS
VERBOSE: ClientRequestId: 59a9275c-9005-4e8a-b68b-efa1e6c27d47_PS
VERBOSE: 1 StorSimple device found!
VERBOSE: ClientRequestId: 08e5142a-b038-4607-8690-0c5a8b948352_PS
VERBOSE: ClientRequestId: 218af244-b8f4-4a4b-817e-8f67e1323f03_PS
VERBOSE: About to configure the device : Device22 !
VERBOSE: ClientRequestId: fbd1f32d-1d74-432e-9dc0-90b46674884a_PS
VERBOSE: The task created for your Setup operation has completed successfully.
VERBOSE: ClientRequestId: 981cb941-252c-4898-ba9f-f19e5b8bcaa4_PS
VERBOSE: Successfully updated configuration for device Device22 with id 865e68f6-1e71-47b6-80d5-15d3a23bd2b0
この例では、最初の例と同じ構成更新を行います。ただし、最後のコマンドがパイプライン演算子を使用して現在のコマンドレットにタイム ゾーン オブジェクトを渡す点が異なります。
パラメーター
-DeviceId
構成する StorSimple デバイスのインスタンス ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeviceName
構成する StorSimple デバイスのフレンドリ名を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NewName
StorSimple デバイスの新しいフレンドリ名を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Profile
Azure プロファイルを指定します。
型: | AzureSMProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SecondaryDnsServer
StorSimple デバイスのセカンダリ DNS サーバーを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-StorSimpleNetworkConfig
デバイス上のインターフェイスのネットワーク構成オブジェクトの配列を指定します。 NetworkConfig オブジェクトを取得するには、New-AzureStorSimpleNetworkConfig コマンドレットを使用します。
型: | NetworkConfig[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-TimeZone
デバイスのタイム ゾーンを指定します。
GetSystemTimeZone() メソッドを使用して TimeZoneInfo オブジェクトを作成できます。
たとえば、次のコマンドは、太平洋標準時のタイム ゾーン情報オブジェクトを作成します。 \[System.TimeZoneInfo\]::GetSystemTimeZones() | where { $_.Id -eq "Pacific Standard Time" }
型: | TimeZoneInfo |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
NetworkConfig, TimeZoneInfo
NetworkConfig オブジェクトまたは TimeZoneInfo をこのコマンドレットにパイプできます。
出力
DeviceDetails
このコマンドレットは、仮想デバイスの更新されたデバイスの詳細を返します。