PowerShell-Dokufehler für New-IscsiServerTarget

Dieser Tage stieß ich auf einen Fehler in der Online-Hilfe der PowerShell von Windows Server 2012 und Windows 8. Beim Versuch, ein iSCSI-Target auf dem Server einzurichten, das für einen Cluster geeignet ist (und daher für mehr als einen zugreifenden Server freigegeben werden muss), erhielt ich folgende Fehlermeldung:

PS C:\Users\administrator.ACHT> New-IscsiServerTarget -Targetname „trg-quorum02“ -InitiatorIds „IPAddress:172.16.1.11,IPAddress:172.16.1.12“
New-IscsiServerTarget : Der Parameter „InitiatorIds“ kann nicht gebunden werden. Der Wert
„IPAddress:172.16.1.11,IPAddress:172.16.1.12“ kann nicht in den Typ „Microsoft.Iscsi.Target.Commands.InitiatorId“ konvertiert
werden. Fehler: „Die IPv4-Adresse kann nicht überprüft werden.
Parametername: value“
In Zeile:1 Zeichen:64
+ New-IscsiServerTarget -Targetname „trg-quorum02“ -InitiatorIds „IPAddress:172.16 …
+                                                                ~~~~~~~~~~~~~~~~~
+ CategoryInfo          : InvalidArgument: (:) [New-IscsiServerTarget], ParameterBindingException
+ FullyQualifiedErrorId : CannotConvertArgumentNoMessage,Microsoft.Iscsi.Target.Commands.NewIscsiServerTargetCommand

Die Online-Hilfe der PowerShell schlägt aber exakt diese Syntax vor:

Leider ist dieses Beispiel aber falsch. Ein Blick in das “Schwester-Cmdlet” Set-iSCSIServerTarget zeigt einen kleinen, aber wichtigen Unterschied:

Die Anführungsstriche dürfen nicht das ganze Array von IDs umfassen, sondern jede ID ist einzeln in Anführungsstriche zu setzen. Die folgende Korrektur funktioniert daher auch:

New-IscsiServerTarget -Targetname „trg-quorum02“ -InitiatorIds „IPAddress:172.16.1.11″,“IPAddress:172.16.1.12“