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>] [-WarningAction <ActionPreferen
ce>] [-WarningVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]


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, "default" 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
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 DataONTAP controller object, embodied by an NaController object. Th
is parameter is returned by the Connect-NaController cmdlet. If not spe
cified, the value in the global variable CurrentNaController is used.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WarningAction <ActionPreference>


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WarningVariable <String>


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
NetApp.Ontapi.Filer.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'.


InitiatorGroupAluaEnabled : False
InitiatorGroupName : igroup4
InitiatorGroupOsType : windows
InitiatorGroupPortsetName :
InitiatorGroupThrottleBorrow : False
InitiatorGroupThrottleReserve : 0
InitiatorGroupType : iscsi
InitiatorGroupUsePartner :
InitiatorGroupVsaEnabled : False
Initiators : {}
LunId :
InitiatorGroupUsePartnerSpecified : False
LunIdSpecified : False



RELATED LINKS
Get-NaIgroup
Remove-NaIgroup







 Data ONTAP® PowerShell Toolkit