Data ONTAP® PowerShell Toolkit

Cmdlet: Remove-NaIgroupInitiator


NAME
Remove-NaIgroupInitiator

SYNOPSIS
Removes node(s) from an initiator group.

SYNTAX
Remove-NaIgroupInitiator [-Igroup] <String> [-Initiator] <String> [-Force] [
-Controller <NaController>] [-WarningAction <ActionPreference>] [-WarningVar
iable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]


DESCRIPTION
Removes node(s) from an initiator group. The operation is prohibited if ther
e are existing lun maps defined for that group. The force option set to "tru
e" can be used to forcibly remove the node regardless of mappings.


PARAMETERS
-Igroup <String>
Name of initiator group.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-Initiator <String>
Initiator to remove.

Required? true
Position? 2
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-Force
Forcibly remove the initiator even if there are existing LUNs mapped to
this initiator group. Best practice is to attempt to unmap all the luns
associated with a group before removing the initiator.

Required? false
Position? named
Default value
Accept pipeline input? false
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-remove

-------------- Example 1 --------------

C:\PS>Remove-NaIgroupInitiator igroup4 iqn.1991-05.com.microsoft:xyratex02


Remove an initiator on server 'xyratex02' from igroup 'igroup4'.


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



RELATED LINKS
Add-NaIgroupInitiator
Get-NaIgroup







 Data ONTAP® PowerShell Toolkit