Freigeben über

Set-AzureStorSimpleDevice

  • Referenz
Modul:
Azure

Ändert die Gerätekonfiguration für ein Gerät.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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>]

Beschreibung

Das Cmdlet Set-AzureStorSimpleDevice ändert die Gerätekonfiguration für ein Gerät. Wenn Sie ein Gerät zum ersten Mal einrichten, müssen Sie die Parameter TimeZone, SecondaryDnsServer und StorSimpleNetworkConfig angeben. Sie müssen die Netzwerkkonfiguration für Data0 mit Controller0 und Controller1 und IP-Adressen einschließen. Es muss mindestens eine Internet-SCSI(ISCSI)-fähige Netzwerkschnittstelle vorhanden sein, um das Gerät zum ersten Mal zu konfigurieren.

Beispiele

Beispiel 1: Ändern der Konfiguration für ein Gerät

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

Der erste Befehl erstellt eine Netzwerkkonfiguration für die Data0-Schnittstelle. Dieser Befehl gibt die Parameter Controller0IPv4Address, Controller1IPv4Address und EnableIscsi an. Der Befehl speichert das Ergebnis in der variablen $NetworkConfigData 0.

Der zweite Befehl verwendet die System.TimeZoneInfo .NET-Klasse und die Standardsyntax, um pacific Standard Time zone abzurufen, und speichert dieses Objekt in der $TimeZoneInfo Variablen.

Der dritte Befehl verwendet das Cmdlet "Get-AzureStorSimpleDevice " und das Where-Object-Kern-Cmdlet , um ein Online-StorSimple-Gerät abzurufen, und speichert es dann in der $OnlineDevice Variablen.

Der letzte Befehl ändert die Konfiguration für das Gerät mit der angegebenen Geräte-ID. Der Befehl verwendet das Konfigurationsobjekt, das das aktuelle Cmdlet im ersten Befehl erstellt hat. Der Befehl verwendet die in $TimeZoneInfo gespeicherte Zeitzone.

Beispiel 2: Pfeifen des Konfigurationsobjekts zum Ändern eines Geräts

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

In diesem Beispiel wird dieselbe Konfigurationsaktualisierung wie im ersten Beispiel ausgeführt, mit der Ausnahme, dass der letzte Befehl das Netzwerkkonfigurationsobjekt mithilfe des Pipelineoperators an das aktuelle Cmdlet übergibt.

Beispiel 3: Pfeifen des Zeitzonenobjekts zum Ändern eines Geräts

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

In diesem Beispiel wird dieselbe Konfigurationsaktualisierung wie im ersten Beispiel ausgeführt, mit der Ausnahme, dass der letzte Befehl das Zeitzonenobjekt mithilfe des Pipelineoperators an das aktuelle Cmdlet übergibt.

Parameter

-DeviceId

Gibt die Instanz-ID des zu konfigurierenden StorSimple-Geräts an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceName

Gibt den Anzeigenamen des zu konfigurierenden StorSimple-Geräts an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NewName

Gibt den neuen Anzeigenamen des StorSimple-Geräts an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

Gibt ein Azure-Profil an.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SecondaryDnsServer

Gibt einen sekundären DNS-Server für das StorSimple-Gerät an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StorSimpleNetworkConfig

Gibt ein Array von Netzwerkkonfigurationsobjekten für Schnittstellen auf einem Gerät an. Verwenden Sie zum Abrufen eines NetworkConfig-Objekts das Cmdlet New-AzureStorSimpleNetworkConfig.

Typ:NetworkConfig[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TimeZone

Gibt eine Zeitzone für das Gerät an. Sie können ein TimeZoneInfo-Objekt mithilfe der GetSystemTimeZone()- Methode erstellen. Mit diesem Befehl wird beispielsweise ein Zeitzoneninformationsobjekt für Pacific Standard Time erstellt: \[System.TimeZoneInfo\]::GetSystemTimeZones() | where { $_.Id -eq "Pacific Standard Time" }

Typ:TimeZoneInfo
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

NetworkConfig, TimeZoneInfo

Sie können ein NetworkConfig-Objekt oder ein TimeZoneInfo-Objekt an dieses Cmdlet weiterleiten.

Ausgaben

DeviceDetails

Dieses Cmdlet gibt aktualisierte Gerätedetails für das virtuelle Gerät zurück.