|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Remove-NaIscsiInterfaceAccess
NAME
Remove-NaIscsiInterfaceAccess
SYNOPSIS
Remove the named network interfaces from the accesslist for the specified in
itiator.
SYNTAX
Remove-NaIscsiInterfaceAccess [-Initiator] <String> [-Interface] <String[]>
[-Controller <NaController>] [<CommonParameters>]
Remove-NaIscsiInterfaceAccess [-Initiator] <String> [-All] [-Controller <NaC
ontroller>] [<CommonParameters>]
DESCRIPTION
Remove the named network interfaces from the accesslist for the specified in
itiator. If this command leaves the initiator's accesslist empty, the access
list itself is removed.
Creating or modifying an accesslist may require shutting down existing iSCSI
sessions associated with network interfaces that no longer appear on the ac
cesslist. For example, creating a new accesslist via the add operation may c
ause sessions to be shut down on network interfaces that are not in the new
accesslist. Likewise, removing network interfaces from an existing accesslis
t via the remove operation may also cause sessions to be shut down. Note th
at adding all interfaces (using -All) and removing all interfaces (using -Al
l) will not affect any iSCSI sessions.
PARAMETERS
-Initiator <String>
The initiator for which to remove from the accesslist.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Interface <String[]>
One or more interfaces to remove from the accesslist.
Required? true
Position? 2
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
-All
If specified, remove all interfaces from the accesslist.
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
NOTES
Category: iscsi
API: system-cli
Privilege: security-priv-admin, cli-iscsi-interface-accesslist-remove
-------------- Example 1 --------------
C:\PS>Remove-NaIscsiInterfaceAccess -Initiator (Get-NaHostIscsiAdapter).Iqn
-All
Remove all the interfaces from the accesslist for the current host's iSCSI i
nitiator.
RELATED LINKS
Add-NaIscsiInterfaceAccess
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|