|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: New-NaIgroup
NAME
New-NaIgroup
SYNOPSIS
Creates a new initiator group.
SYNTAX
New-NaIgroup [-Name] <String> [-Protocol] <String> [[-Type] <String>] [[-Por
tset] <String>] [-Controller <NaController>] [-WhatIf] [-Confirm] [<CommonPa
rameters>]
DESCRIPTION
Creates a new initiator group.
PARAMETERS
-Name <String>
Name of initiator group.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Protocol <String>
Type of the initiator group, currently only "iscsi" and "fcp" are suppor
ted.
Required? true
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Type <String>
OS type of the initiators within the group. While optional, this field s
hould always be specified. Please see Note below. The type applies to a
ll initiators within the group and governs the finer details of SCSI pro
tocol interaction with these initiators. Valid arguments are "default",
"solaris", "windows", "hpux", "aix", "linux", "netware" and "vmware".
If not specified, "windows" is used.
*NOTE* It is strongly recommended for the caller of this API to specify
an OS type that is not "default". Some host OSes require this type fiel
d be set correctly in order to function properly.
Required? false
Position? 3
Default value windows
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Portset <String>
Name of a current portset to bind to the newly created igroup.
Required? false
Position? 4
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".
INPUTS
OUTPUTS
DataONTAP.Types.Lun.InitiatorGroupInfo
NOTES
Category: igroup
API: igroup-create
-------------- Example 1 --------------
C:\PS>New-NaIgroup igroup4 iscsi windows
Create a new igroup 'igroup4' with protocol type 'iscsi' and os type 'window
s'.
InitiatorGroupName : igroup4
InitiatorGroupType : iscsi
Initiators : {}
InitiatorGroupOsType : windows
InitiatorGroupPortsetName :
InitiatorGroupThrottleBorrow : False
InitiatorGroupThrottleReserve : 0
InitiatorGroupUsePartner :
InitiatorGroupAluaEnabled : False
InitiatorGroupVsaEnabled : False
LunId :
RELATED LINKS
Get-NaIgroup
Remove-NaIgroup
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|