共用方式為

Set-AzureStorSimpleDevice

  • 參考
模組:
Azure

變更裝置的裝置組態。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 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>]

Description

Set-AzureStorSimpleDevice Cmdlet 會變更裝置的裝置設定。 如果您要第一次設定裝置，您必須指定 TimeZone、 SecondaryDnsServer 和 StorSimpleNetworkConfig 參數。 您必須包含 Data0 與 controller0 和 controller1 和 IP 位址的網路組態。 至少必須有一個已啟用因特網 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 變數中。

第二個命令會使用 System.TimeZoneInfo .NET 類別和標準語法來取得太平洋標準時區，並將該物件儲存在$TimeZoneInfo變數中。

第三個命令會使用 Get-AzureStorSimpleDevice Cmdlet 和 Where-Object 核心 Cmdlet 來取得在線 StorSimple 裝置，然後將它儲存在$OnlineDevice變數中。

最後一個命令會修改具有指定裝置標識碼之裝置的組態。 命令會使用目前在第一個命令中建立的 Cmdlet 組態物件。 此命令會使用儲存在 $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

此範例會執行與第一個範例相同的組態更新，但最後一個命令會使用管線運算符，將網路組態對象傳遞至目前的 Cmdlet。

範例 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

這個範例會執行與第一個範例相同的組態更新，但最後一個命令會使用管線運算符，將時區對象傳遞至目前的 Cmdlet。

參數

-DeviceId

指定要設定之 StorSimple 裝置的實例識別碼。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-DeviceName

指定要設定的 StorSimple 裝置易記名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-NewName

指定 StorSimple 裝置的新易記名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Profile

指定 Azure 設定檔。

類型:AzureSMProfile
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SecondaryDnsServer

指定 StorSimple 裝置的次要 DNS 伺服器。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-StorSimpleNetworkConfig

指定裝置上介面的網路組態物件數位。 若要取得 NetworkConfig 物件，請使用 New-AzureStorSimpleNetworkConfig Cmdlet。

類型:NetworkConfig[]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-TimeZone

指定裝置的時區。 您可以使用 GetSystemTimeZone（） 方法來建立 TimeZoneInfo 物件。 例如，此命令會建立太平洋標準時間的時區信息物件： \[System.TimeZoneInfo\]::GetSystemTimeZones() | where { $_.Id -eq "Pacific Standard Time" }

類型:TimeZoneInfo
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

輸入

NetworkConfig, TimeZoneInfo

您可以使用管線將 NetworkConfig 物件或 TimeZoneInfo 傳送至此 Cmdlet。

輸出

DeviceDetails

此 Cmdlet 會傳回虛擬設備更新的裝置詳細數據。